samedaydesk-com Blockchain API

openapi: 3.2.0
info:
  title: SameDayDesk machine commerce gateway Blockchain API
  version: 1.23.55
  description: Deterministic agent APIs for web and company intelligence, repository security, agent-work economics, machine-service discoverability, payment preflight and settlement proof, wallet context, and Morpho decision evidence. Pay per call through Base x402, with a Circle Gateway Nanopayments path for gasless batched USDC.
  contact:
    email: contact@samedaydesk.com
    url: https://samedaydesk.com
  x-guidance: Choose the narrowest route that answers the task. Supply required query parameters, inspect the currently advertised HTTP 402 offers, enforce your own price and network policy, then retry the identical method, path, and query with one supported payment credential. Treat runtime payment challenges as authoritative.
servers:
- url: https://agents.samedaydesk.com
tags:
- name: Blockchain
paths:
  /commerce/settlement-proof:
    get:
      summary: Verify one claimed canonical Base USDC settlement against the successful…
      parameters:
      - name: transactionHash
        in: query
        required: true
        description: Base mainnet transaction hash whose canonical USDC Transfer logs should be checked.
        schema:
          type: string
          pattern: ^0x[0-9a-fA-F]{64}$
          example: '0xcfcbb367fecf27052db9ca855e5146e99cacbce1cab94f20f9f95a74170a8987'
      - name: recipient
        in: query
        required: true
        description: Expected USDC recipient.
        schema:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
          example: '0x8904dF3DE6DFEe6a7C8cc38619d2f17806213Cee'
      - name: amountAtomic
        in: query
        required: true
        description: Expected positive USDC amount in six-decimal atomic units.
        schema:
          type: string
          pattern: ^[1-9][0-9]{0,20}$
          maxLength: 21
          example: '5000'
      - name: payer
        in: query
        required: false
        description: Optional expected USDC payer.
        schema:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
      responses:
        '200':
          description: deterministic canonical Base USDC settlement proof or mismatch findings
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                  product:
                    type: string
                    const: samedaydesk-base-usdc-settlement-proof
                  version:
                    type: string
                  checkedAt:
                    type: string
                  decision:
                    type: string
                    enum:
                    - verified
                    - not_verified
                    - receipt_unavailable
                  request:
                    type: object
                  chain:
                    type: object
                  asset:
                    type: object
                  transaction:
                    type: object
                  settlement:
                    type: object
                  findings:
                    type: array
                  boundary:
                    type: object
                required:
                - ok
                - product
                - version
                - checkedAt
                - decision
                - request
                - chain
                - asset
                - transaction
                - settlement
                - findings
                - boundary
              example:
                ok: true
                product: samedaydesk-base-usdc-settlement-proof
                version: 1.0.0
                checkedAt: '2026-08-11T08:30:00.000Z'
                decision: verified
                request:
                  transactionHash: 0xcfcbb3...a8987
                  recipient: '0x8904dF3DE6DFEe6a7C8cc38619d2f17806213Cee'
                  amountAtomic: '5000'
                  payer: 0x990C...7f17
                chain:
                  id: 8453
                  name: Base mainnet
                  network: eip155:8453
                asset:
                  address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
                  symbol: USDC
                  decimals: 6
                transaction:
                  hash: 0xcfcbb3...a8987
                  status: success
                  blockNumber: '49823378'
                  blockTimestamp: '2026-08-11T08:15:03.000Z'
                settlement:
                  verified: true
                  exactTransferCount: 1
                  recipientTransferCount: 1
                  observed:
                    payer: 0x990C...7f17
                    recipient: '0x8904dF3DE6DFEe6a7C8cc38619d2f17806213Cee'
                    amountAtomic: '5000'
                    amountUsdc: '0.005'
                findings: []
                boundary:
                  source: public Base mainnet receipt and logs
                  privateLedgerRead: false
                  auditedTransactionModified: false
                  walletAccessed: false
                  executionAuthorized: false
        '400':
          description: invalid settlement claim, charged nothing
        '402':
          description: payment required (x402, $0.005 USDC base)
      operationId: verifyBaseUsdcSettlement
      tags:
      - Blockchain
      x-payment-info:
        operation:
          id: commerce_settlement-proof
          price: '5000'
          billingBasis: per-call
          supportedRails:
          - x402
        price:
          amount: '0.005'
          currency: USD
          mode: fixed
        protocols:
        - x402:
            asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
            network: eip155:8453
            scheme: exact
  /chain/transaction-receipt:
    get:
      summary: 'Get a normalized Base or Ethereum transaction receipt from one hash: success or…'
      parameters:
      - name: transactionHash
        in: query
        required: true
        description: Mined Base or Ethereum transaction hash whose normalized receipt should be returned.
        schema:
          type: string
          pattern: ^0x[0-9a-fA-F]{64}$
      - name: network
        in: query
        required: false
        description: Receipt network. Defaults to Base mainnet.
        schema:
          type: string
          enum:
          - base
          - ethereum
          default: base
      responses:
        '200':
          description: normalized transaction receipt with fee and decoded transfer evidence
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                  product:
                    type: string
                    const: samedaydesk-transaction-receipt
                  version:
                    type: string
                  checkedAt:
                    type: string
                  decision:
                    type: string
                    enum:
                    - found
                    - not_found
                    - rpc_unavailable
                  request:
                    type: object
                  chain:
                    type: object
                  transaction:
                    type: object
                  receipt:
                    type: object
                  transfers:
                    type: array
                  canonicalUsdcTransfers:
                    type: array
                  findings:
                    type: array
                  boundary:
                    type: object
                required:
                - ok
                - product
                - version
                - checkedAt
                - decision
                - request
                - chain
                - transaction
                - receipt
                - transfers
                - canonicalUsdcTransfers
                - findings
                - boundary
              example:
                ok: true
                product: samedaydesk-transaction-receipt
                version: 1.0.0
                checkedAt: '2026-08-11T13:50:00.000Z'
                decision: found
                request:
                  transactionHash: 0xcfcbb3...a8987
                  network: base
                chain:
                  id: 8453
                  name: Base mainnet
                  network: eip155:8453
                transaction:
                  hash: 0xcfcbb3...a8987
                  status: success
                  blockNumber: '49823378'
                  blockTimestamp: '2026-08-11T08:15:03.000Z'
                  gasUsedAtomic: '128761'
                  effectiveGasPriceWei: '10000000'
                  transactionFeeWei: '1287610000000'
                receipt:
                  found: true
                  logCount: 2
                  decodedTransferCount: 1
                  canonicalUsdcTransferCount: 1
                  transfersTruncated: false
                transfers:
                - token: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
                  from: 0x990C...7f17
                  to: '0x8904dF3DE6DFEe6a7C8cc38619d2f17806213Cee'
                  amountAtomic: '5000'
                  canonicalUsdc: true
                  amountUsdc: '0.005'
                  logIndex: '1'
                canonicalUsdcTransfers:
                - token: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
                  from: 0x990C...7f17
                  to: '0x8904dF3DE6DFEe6a7C8cc38619d2f17806213Cee'
                  amountAtomic: '5000'
                  canonicalUsdc: true
                  amountUsdc: '0.005'
                  logIndex: '1'
                findings: []
                boundary:
                  source: bounded public Base mainnet receipt and block RPC
                  rawLogsReturned: false
                  privateLedgerRead: false
                  walletAccessed: false
                  transactionSigned: false
                  transactionBroadcast: false
                  transactionModified: false
        '400':
          description: invalid hash or unsupported network, charged nothing
        '402':
          description: payment required (x402, $0.002 USDC base)
      operationId: getTransactionReceipt
      tags:
      - Blockchain
      x-payment-info:
        operation:
          id: chain_transaction-receipt
          price: '2000'
          billingBasis: per-call
          supportedRails:
          - x402
        price:
          amount: '0.002'
          currency: USD
          mode: fixed
        protocols:
        - x402:
            asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
            network: eip155:8453
            scheme: exact
  /chain/solana-transaction-receipt:
    get:
      summary: Get a normalized finalized Solana transaction receipt from one signature…
      parameters:
      - name: signature
        in: query
        required: true
        description: Finalized Solana mainnet transaction signature.
        schema:
          type: string
          pattern: ^[1-9A-HJ-NP-Za-km-z]{80,90}$
          example: GKYyX4foVCLRN4b8b7qBTXXf9iEAtrdqzez4U1rwgEhUt99cmyXwPQ4JhsEu4PFbWFNj3ZKZbxTVNwHJKK17ahc
      - name: mint
        in: query
        required: false
        description: SPL-token mint to verify. Defaults to canonical Solana USDC.
        schema:
          type: string
          pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
          default: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
      - name: recipient
        in: query
        required: false
        description: Optional expected token recipient owner.
        schema:
          type: string
          pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
      - name: amountAtomic
        in: query
        required: false
        description: Optional expected positive token amount in atomic units; requires recipient.
        schema:
          type: string
          pattern: ^[1-9][0-9]{0,19}$
      - name: payer
        in: query
        required: false
        description: Optional expected token payer owner; requires recipient and amountAtomic.
        schema:
          type: string
          pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
      responses:
        '200':
          description: normalized finalized Solana receipt and optional exact SPL-token settlement verification
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                  product:
                    type: string
                    const: samedaydesk-solana-transaction-receipt
                  version:
                    type: string
                  checkedAt:
                    type: string
                  decision:
                    type: string
                    enum:
                    - found
                    - verified
                    - not_verified
                    - not_found
                    - rpc_unavailable
                  request:
                    type: object
                  chain:
                    type: object
                  transaction:
                    type: object
                  receipt:
                    type: object
                  tokenOwnerDeltas:
                    type: array
                  canonicalUsdcOwnerDeltas:
                    type: array
                  verification:
                    type: object
                  findings:
                    type: array
                  boundary:
                    type: object
                required:
                - ok
                - product
                - version
                - checkedAt
                - decision
                - request
                - chain
                - transaction
                - receipt
                - tokenOwnerDeltas
                - canonicalUsdcOwnerDeltas
                - verification
                - findings
                - boundary
              example:
                ok: true
                product: samedaydesk-solana-transaction-receipt
                version: 1.0.0
                checkedAt: '2026-08-11T21:12:00.000Z'
                decision: found
                request:
                  signature: 3CjY...GNZn
                  mint: EPjF...Dt1v
                  recipient: null
                  amountAtomic: null
                  payer: null
                chain:
                  name: Solana mainnet
                  network: solana:mainnet
                  canonicalUsdc: EPjF...Dt1v
                transaction:
                  signature: 3CjY...GNZn
                  status: success
                  slot: '438431606'
                  blockTime: '2026-08-11T14:40:00.000Z'
                  feeLamports: '5000'
                receipt:
                  found: true
                  finalized: true
                  tokenOwnerDeltaCount: 2
                  canonicalUsdcDeltaCount: 2
                tokenOwnerDeltas: []
                canonicalUsdcOwnerDeltas: []
                verification:
                  requested: false
                  matched: false
                findings: []
                boundary:
                  source: bounded public Solana mainnet finalized transaction RPC
                  rawInstructionsReturned: false
                  rawLogsReturned: false
                  privateLedgerRead: false
                  walletAccessed: false
                  transactionSigned: false
                  transactionBroadcast: false
                  transactionModified: false
        '400':
          description: invalid signature or settlement claim, charged nothing
        '402':
          description: payment required (x402, $0.002 USDC base)
      operationId: getSolanaTransactionReceipt
      tags:
      - Blockchain
      x-payment-info:
        operation:
          id: chain_solana-transaction-receipt
          price: '2000'
          billingBasis: per-call
          supportedRails:
          - x402
        price:
          amount: '0.002'
          currency: USD
          mode: fixed
        protocols:
        - x402:
            asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
            network: eip155:8453
            scheme: exact
  /wallet-enrich:
    get:
      summary: 'Base/EVM address -> agent-ready on-chain profile in one call: EOA vs contract…'
      parameters:
      - name: address
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: agent-ready on-chain profile (type, native + token holdings, contract/token metadata, proxy, activity, profile label)
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                  address:
                    type: string
                  type:
                    type: string
                    enum:
                    - eoa
                    - contract
                  native:
                    type: object
                  tokenHoldings:
                    type: array
                  holdingsSummary:
                    type: object
                  contract:
                    type: object
                  activity:
                    type: object
                  profile:
                    type: string
                required:
                - ok
                - address
                - type
              example:
                ok: true
                address: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913'
                network: base-mainnet (eip155:8453)
                type: contract
                native:
                  symbol: ETH
                  balance: '0.0098'
                tokenHoldings:
                - symbol: USDC
                  amount: '1000.0'
                  kind: stable
                holdingsSummary:
                  distinctTokens: 1
                  stablecoinUnits: 1000
                  hasStablecoins: true
                contract:
                  standard: ERC-20 (token)
                  token:
                    symbol: USDC
                    name: USD Coin
                    decimals: 6
                    totalSupply: '4157703919.56'
                profile: token-contract:USDC
        '402':
          description: payment required (x402, $0.05 USDC base)
        '502':
          description: Base RPC unavailable; no wallet type was inferred
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    const: false
                  address:
                    type: string
                  error:
                    type: string
                    const: wallet_enrichment_upstream_unavailable
                required:
                - ok
                - address
                - error
                additionalProperties: false
      operationId: enrichWallet
      tags:
      - Blockchain
      x-payment-info:
        operation:
          id: wallet-enrich
          price: '50000'
          billingBasis: per-call
          supportedRails:
          - x402
        price:
          amount: '0.05'
          currency: USD
          mode: fixed
        protocols:
        - x402:
            asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
            network: eip155:8453
            scheme: exact
x-service-info:
  categories:
  - agentic-payments
  - machine-commerce
  - data
  - defi
  docs:
    extractionTrial: https://agents.samedaydesk.com/.well-known/extraction-trial
    apiReference: https://agents.samedaydesk.com/openapi.json
    homepage: https://agents.samedaydesk.com
    llms: https://agents.samedaydesk.com/llms.txt
    buyerPolicyReference: https://github.com/epistemedeus/agent-payment-policy
    purchaseEvidence: https://agents.samedaydesk.com/.well-known/agent-payment-evidence.json
    callerResultClient: https://neomorphic.io/downloads/samedaydesk-caller-result/0.1.2/descriptor.json
    callerResultArchive: https://neomorphic.io/downloads/samedaydesk-caller-result/0.1.2/samedaydesk-caller-result-0.1.2.tar.gz
  callerResultClient:
    schema: samedaydesk.caller-result-client.v1
    name: samedaydesk-caller-result
    version: 0.1.2
    license: MIT
    optional: true
    charged: false
    paymentRequired: false
    npmPublished: false
    nodeMinimum: 22.12.0
    archiveUrl: https://neomorphic.io/downloads/samedaydesk-caller-result/0.1.2/samedaydesk-caller-result-0.1.2.tar.gz
    sha256: df8cf4e24d437a0d49779cd2fee87b8145c6c8cb171a0b9f68b1c1a2195c322c
    descriptorUrl: https://neomorphic.io/downloads/samedaydesk-caller-result/0.1.2/descriptor.json
    sourceUrl: https://github.com/epistemedeus/x402-url-extractor/tree/f8b939c5dc7a66d59b2b2d6358f3158dfa56d542/caller-result-client
    sdk:
      '@modelcontextprotocol/sdk': 1.30.0
      '@x402/mcp': 2.16.0
    install:
    - mkdir samedaydesk-caller-result
    - tar -xzf samedaydesk-caller-result-0.1.2.tar.gz -C samedaydesk-caller-result
    - cd samedaydesk-caller-result
    - npm ci --ignore-scripts
    modules:
      mcp:
        exportName: bindPaidMcpCallerResult
        specifier: ./src/mcp-caller-result.mjs
        packageExport: samedaydesk-caller-result/mcp
      http:
        exportNames:
        - bindCallerResultFeedback
        - reportCallerResult
        specifier: ./src/http-caller-result.mjs
        packageExport: samedaydesk-caller-result/http
      recovery:
        exportNames:
        - startPaidMcpResult
        - resumePaidMcpResult
        specifier: ./src/mcp-recovery.mjs
        packageExport: samedaydesk-caller-result/recovery
        bin: bin/recover-mcp.mjs
      continuation:
        exportNames:
        - discoverHttpNextActions
        - discoverSdkNextActions
        - retrieveEntitledHttp
        specifier: ./src/continuation.mjs
        packageExport: samedaydesk-caller-result/continuation
    feedback:
      optional: true
      charged: false
      usefulness: unknown
      dispositions:
      - useful
      - not_useful
      http:
        method: POST
        path: /commerce/caller-result-feedback
        header: x-samedaydesk-caller-result-feedback
        schema: samedaydesk.caller-result-feedback.v1
      mcp:
        tool: report_caller_result
        method: tools/call
        metaKey: samedaydesk/mcp-caller-result
        schema: samedaydesk.caller-result-feedback.mcp.v1
        wrapperOmitsMeta: true
    feedbackArchive:
      version: 0.1.0
      archiveUrl: https://neomorphic.io/downloads/samedaydesk-caller-result/0.1.0/samedaydesk-caller-result-0.1.0.tar.gz
      sha256: 3c134598697aadb038a98bfee4ad6e82472df34d3fa325e19507a33ed5dc974b
      containsRecovery: false
      relativePath: caller-result-client/export/public/bytes/samedaydesk-caller-result/0.1.0/samedaydesk-caller-result-0.1.0.tar.gz
    nextAction: Download the current archive, verify sha256, unpack with the install lines, and import bindPaidMcpCallerResult. Optional recovery of an already authorized paid result imports startPaidMcpResult and resumePaidMcpResult from samedaydesk-caller-result/recovery, or runs node bin/recover-mcp.mjs in a second process. The 0.1.0 archive is feedback only. Report useful or not_useful only when you choose. Skipping the statement leaves the purchase.