GoldRush Foundational API — Transactions

naftiko: 1.0.0-alpha2
info:
  label: GoldRush Foundational API — Transactions
  description: v3 transaction lookups by address, block, time bucket, and tx hash. Self-contained Naftiko capability.
  tags:
  - Covalent
  - GoldRush
  - Transactions
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    GOLDRUSH_API_KEY: GOLDRUSH_API_KEY
capability:
  consumes:
  - type: http
    namespace: foundational-transactions
    baseUri: https://api.covalenthq.com
    description: GoldRush Foundational API — Transactions.
    resources:
    - name: recent-transactions
      path: /v1/{chainName}/address/{walletAddress}/transactions_v3/
      operations:
      - { name: getRecentTransactions, method: GET, description: 'Get Recent Transactions For Address (v3).', outputRawFormat: json }
    - name: paginated-transactions
      path: /v1/{chainName}/address/{walletAddress}/transactions_v3/page/{page}/
      operations:
      - { name: getPaginatedTransactions, method: GET, description: 'Get Paginated Transactions For Address (v3).', outputRawFormat: json }
    - name: earliest-transactions
      path: /v1/{chainName}/address/{walletAddress}/transactions_v3/earliest/
      operations:
      - { name: getEarliestTransactions, method: GET, description: 'Get Earliest Transactions For Address (v3).', outputRawFormat: json }
    - name: bulk-time-bucket
      path: /v1/{chainName}/bulk/transactions/{walletAddress}/{timeBucket}/
      operations:
      - { name: getBulkTimeBucketTransactions, method: GET, description: 'Get Bulk Time Bucket Transactions For Address (v3).', outputRawFormat: json }
    - name: transaction-summary
      path: /v1/{chainName}/address/{walletAddress}/transactions_summary/
      operations:
      - { name: getTransactionSummary, method: GET, description: 'Get Transaction Summary For Address.', outputRawFormat: json }
    - name: transaction
      path: /v1/{chainName}/transaction_v2/{txHash}/
      operations:
      - { name: getTransaction, method: GET, description: 'Get A Transaction.', outputRawFormat: json }
    - name: block-transactions
      path: /v1/{chainName}/block/{blockHeight}/transactions_v3/
      operations:
      - { name: getBlockTransactions, method: GET, description: 'Get All Transactions In A Block (v3).', outputRawFormat: json }
    authentication:
      type: apikey
      key: Authorization
      value: 'Bearer {{env.GOLDRUSH_API_KEY}}'
      placement: header
  exposes:
  - type: mcp
    namespace: foundational-transactions-mcp
    port: 9090
    transport: http
    description: MCP adapter exposing one tool per Transactions operation.
    tools:
    - { name: goldrush-get-recent-transactions, description: 'Get recent transactions for an address (v3).', hints: { readOnly: true, idempotent: true }, call: foundational-transactions.getRecentTransactions }
    - { name: goldrush-get-paginated-transactions, description: 'Paginate through transactions for an address.', hints: { readOnly: true, idempotent: true }, call: foundational-transactions.getPaginatedTransactions }
    - { name: goldrush-get-earliest-transactions, description: 'Get earliest transactions for an address.', hints: { readOnly: true, idempotent: true }, call: foundational-transactions.getEarliestTransactions }
    - { name: goldrush-get-bulk-time-bucket-transactions, description: 'Bulk time-bucketed transactions for an address.', hints: { readOnly: true, idempotent: true }, call: foundational-transactions.getBulkTimeBucketTransactions }
    - { name: goldrush-get-transaction-summary, description: 'Transaction summary for an address.', hints: { readOnly: true, idempotent: true }, call: foundational-transactions.getTransactionSummary }
    - { name: goldrush-get-transaction, description: 'Fetch a single transaction by hash.', hints: { readOnly: true, idempotent: true }, call: foundational-transactions.getTransaction }
    - { name: goldrush-get-block-transactions, description: 'All transactions in a block (v3).', hints: { readOnly: true, idempotent: true }, call: foundational-transactions.getBlockTransactions }