Skip to content

docs: add getTransactionsForAddress Solana API spec#1173

Open
trevoraron wants to merge 5 commits into
mainfrom
docs/get-transactions-for-address
Open

docs: add getTransactionsForAddress Solana API spec#1173
trevoraron wants to merge 5 commits into
mainfrom
docs/get-transactions-for-address

Conversation

@trevoraron
Copy link
Copy Markdown

Summary

New schemas (transaction.yaml)

  • GetTransactionsForAddressConfigtransactionDetails, sortOrder, limit, paginationToken, before, until, encoding, maxSupportedTransactionVersion, filters
  • GetTransactionsForAddressFiltersstatus (any/succeeded/failed), blockTime, slot, tokenAccounts
  • RangeFilter — reusable gte/lte object used for slot and blockTime range filters
  • GetTransactionsForAddressResultdata array (signatures or full tx objects) + nullable paginationToken

Files changed

  • src/openrpc/chains/_components/solana/methods.yaml — method definition + example
  • src/openrpc/chains/_components/solana/transaction.yaml — new schemas
  • src/openrpc/chains/solana/solana.yaml$ref added in alphabetical order
  • content/api-reference/solana/solana-api-overview.mdx — method added to overview table

@trevoraron trevoraron requested a review from a team as a code owner April 1, 2026 03:33
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 1, 2026

🔗 Preview Mode

Name Status Preview Updated (UTC)
Alchemy Docs ✅ Ready 🔗 Visit Preview May 11, 2026, 4:11 PM

@trevoraron trevoraron requested a review from dimitriedavid April 1, 2026 03:34
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 15024dc159

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment on lines +456 to +458
oneOf:
- $ref: "#/components/schemas/SignatureInfo"
- $ref: "#/components/schemas/TransactionDetails"
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Replace oneOf with anyOf for transaction result union

GetTransactionsForAddressResult.data.items currently uses oneOf for SignatureInfo vs TransactionDetails, but both referenced schemas are permissive objects with no required discriminator fields. A valid signatures payload can satisfy both branches (for example, it has slot/blockTime and extra fields are allowed), which causes oneOf validation to fail and breaks downstream schema validation/codegen for legitimate responses.

Useful? React with 👍 / 👎.

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 1, 2026

🔍 Link Check

Status: ❌ Failed

Summary

Status Count
🔍 Total 8185
✅ Successful 7004
⏳ Timeouts 0
🔀 Redirected 453
👻 Excluded 682
❓ Unknown 0
🚫 Errors 45
⛔ Unsupported 1
Broken links (45) — click to expand

Errors per input

Errors in ./content/api-reference/trace-api/trace-api-resources/what-are-evm-traces.mdx

Errors in ./content/api-reference/data/nft-api/nft-api-faq.mdx

Errors in ./content/tutorials/alchemy-university/ethereum-basics/ethereum-gas.mdx

Errors in ./content/tutorials/smart-wallets/learn-account-abstraction/introduction-to-account-abstraction.mdx

Errors in ./content/tutorials/alchemy-university/smart-contract-basics/what-is-erc-20.mdx

Errors in ./content/wallets/pages/recipes/onramp-funds.mdx

Errors in ./content/api-reference/data/webhooks/custom-webhooks-quickstart/custom-webhooks-quickstart.mdx

Errors in ./content/tutorials/alchemy-university/smart-contract-basics/smart-contract-abi.mdx

Errors in ./content/tutorials/transactions/transaction-history/how-to-get-contract-deployment-transactions-in-a-block.mdx

Errors in ./content/tutorials/transactions/on-chain-events/how-to-get-on-chain-events.mdx

Errors in ./content/tutorials/alchemy-university/solidity-basics/revert-transactions.mdx

Errors in ./content/tutorials/getting-started/developer-best-practices/best-practices-for-deploying-a-smart-contract-on-evm-mainnets-1.mdx

Errors in ./content/tutorials/transactions/transaction-history/integrating-historical-transaction-data-into-your-dapp.mdx

Errors in ./content/wallets/pages/gas-manager-admin-api/gas-manager-faqs.mdx

Errors in ./content/tutorials/understanding-the-evm/blockchain-101.mdx

Errors in ./content/api-reference/arbitrum-nova/arbitrum-nova-deprecation-notice.mdx

Errors in ./content/wallets/wallet-integrations/privy/jwt-auth-migration.mdx

Errors in ./content/api-reference/trace-api/trace-api-resources/what-is-trace-filter.mdx

Errors in ./content/tutorials/alchemy-university/solidity-basics/solidity-mappings.mdx

Errors in ./content/api-reference/trace-api/trace-api-resources/what-is-trace-transaction.mdx

Errors in ./content/tutorials/creating-smart-contracts/how-to-deploy-a-smart-contract-to-the-sepolia-testnet.mdx

Errors in ./content/tutorials/getting-started/developer-best-practices/choosing-a-web3-network.mdx

Errors in ./content/wallets/wallet-integrations/privy/signer-migration-overview.mdx

Errors in ./content/tutorials/alchemy-university/smart-contract-basics/smart-contract-communication.mdx

Errors in ./content/api-reference/starknet/starknet-api-faq.mdx

Errors in ./content/tutorials/transactions/on-chain-events/deep-dive-into-eth-getlogs.mdx

View workflow run

trevoraron and others added 4 commits May 11, 2026 12:04
Adds the new getTransactionsForAddress JSON-RPC method with support for
pagination, sort order, and filtering by status, token account activity,
slot range, and block time range.
…sForAddress

Only slot and blockTime filters are supported in the initial release.
Also adds gt/lt operators to RangeFilter to match the Rust struct.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ctionsForAddress

Max limit is 1,000 for all modes. Document commitment validation behavior.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ts filters, add transactionIndex, fix paginationToken format

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@trevoraron trevoraron force-pushed the docs/get-transactions-for-address branch from ca9b289 to 056ed0e Compare May 11, 2026 16:05
Rebase conflict resolution kept both the PR's new schemas and main's
existing ones, producing duplicate YAML mapping keys for
GetTransactionsForAddressConfig, GetTransactionsForAddressFilters, and
GetTransactionsForAddressResult. Drop main's block (including the
RangeFilter helper, which was only used by it) and regenerate solana.json.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant