# Cloaked

> Your payments, your business. A wallet that doesn’t broadcast your every move. Set up in seconds.

## Cloaked

### The Problem

Most crypto users eventually create a new wallet because their old wallet accumulated too much history.

A single address gradually reveals your balances, your counterparties, the apps you use, and the transactions that connect them all together. Once an address becomes tied to your identity, many users start over.

The workaround is familiar: move funds through an exchange or privacy tool, create a new wallet, withdraw to a fresh address, and try not to reconnect it to the rest of your activity.

<div className="docs-onboarding-flow" aria-label="Old wallet reset flow">
  <div className="docs-onboarding-card docs-onboarding-card-before">
    <div className="docs-onboarding-title">
      <span>Before</span>
      <span aria-hidden="true">❌</span>
    </div>

    <p>
      Send to an exchange, withdraw to a new address, then do it again later. Create another wallet
      every time you need a fresh start.
    </p>

    <div className="docs-onboarding-horizontal-flow">
      <div className="docs-flow-node">
        <span className="docs-logo-single" title="MetaMask">
          <img src="/metamask-logo.svg" alt="MetaMask" />
        </span>

        <span>Used address</span>
      </div>

      <span className="docs-flow-arrow" aria-hidden="true">
        →
      </span>

      <div className="docs-flow-node docs-flow-node-wide">
        <span className="docs-logo-bubbles" aria-label="Coinbase, Kraken, and Binance">
          <span>
            <img src="/exchange-logos/coinbase.png" alt="Coinbase" />
          </span>

          <span>
            <img src="/exchange-logos/kraken.png" alt="Kraken" />
          </span>

          <span>
            <img src="/exchange-logos/binance.png" alt="Binance" />
          </span>
        </span>

        <span>KYC exchange hop</span>
      </div>

      <span className="docs-flow-arrow" aria-hidden="true">
        →
      </span>

      <div className="docs-flow-node">
        <span className="docs-wallet-icon" aria-hidden="true">
          <svg width="19" height="19" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.2" strokeLinecap="round" strokeLinejoin="round">
            <rect width="20" height="12" x="2" y="6" rx="2" />

            <path d="M7 12h.01" />

            <path d="M12 12h.01" />

            <path d="M17 12h.01" />
          </svg>
        </span>

        <span>New wallet</span>
      </div>

      <span className="docs-flow-arrow" aria-hidden="true">
        →
      </span>

      <div className="docs-flow-node">
        <span className="docs-logo-single" title="Rainbow">
          <img src="/rainbow-logo.png" alt="Rainbow" />
        </span>

        <span>Fresh address</span>
      </div>
    </div>
  </div>
</div>

Then do it again later.

Getting a fresh start onchain shouldn't require multiple hops and another wallet.

### What Cloaked Does

Cloaked gives you the benefits of a fresh wallet without creating a new one.

Every time you receive funds, they can land at a fresh self-custodial address that only you control. Cloaked tracks those addresses for you, shows them in a single balance view, and lets you decide which funds to use later.

Instead of managing a growing collection of wallets, you keep one account while maintaining separation between different parts of your onchain life.

Fresh addresses. One balance view. No wallet resets.

<div className="docs-onboarding-flow" aria-label="Cloaked fresh receive flow">
  <div className="docs-onboarding-card docs-onboarding-card-after">
    <div className="docs-onboarding-title">
      <span>After</span>
      <span aria-hidden="true">✅</span>
    </div>

    <p>
      Use one account while each receive can start at a fresh address and move into Incognito when
      you review it.
    </p>

    <div className="docs-onboarding-horizontal-flow">
      <div className="docs-flow-node">
        <span className="docs-logo-bubbles docs-logo-bubbles-wallets" aria-label="MetaMask, Rainbow, and Cloaked">
          <span>
            <img src="/metamask-logo.svg" alt="MetaMask" />
          </span>

          <span>
            <img src="/rainbow-logo.png" alt="Rainbow" />
          </span>

          <span>
            <img src="/onboarding-cloaked-logo.png" alt="Cloaked" />
          </span>
        </span>

        <span>Used address</span>
      </div>

      <span className="docs-flow-arrow" aria-hidden="true">
        →
      </span>

      <div className="docs-flow-node docs-flow-node-cloaked">
        <span className="docs-cloaked-logo" title="Cloaked">
          <img src="/onboarding-cloaked-logo.png" alt="Cloaked" />
        </span>

        <span>Cloaked</span>

        <span className="docs-powered-by">
          Powered by

          <img src="/privacy-pools-logo-black.png" alt="Privacy Pools" />
        </span>
      </div>

      <span className="docs-flow-arrow" aria-hidden="true">
        →
      </span>

      <div className="docs-flow-node">
        <span className="docs-logo-single" title="Cloaked">
          <img src="/onboarding-cloaked-logo.png" alt="Cloaked" />
        </span>

        <span>Fresh address</span>
      </div>
    </div>
  </div>
</div>

### Benefits

* **Fresh receive workflow** — receive at a fresh address, then review and move eligible funds into your Incognito balance before spending
* **One wallet view** — Cloaked aggregates balances across generated addresses so you do not have to manage them manually
* **Full wallet actions** — send, swap, bridge, and cash out from the same account while fresh receive addresses work in the background
* **Advanced address control** — where enabled, choose the specific address-held balances used for a send
* **ENS-native** — receive funds at the `username.clkd.eth` name Cloaked gives you, or link your own ENS name
* **Self-custody** — Cloaked never holds your funds or private keys; everything is recoverable via the [recovery tool](https://recovery.clkd.xyz/)
* **Passkey or wallet** — register with a biometric passkey or connect an existing wallet

### What Cloaked Isn't

Cloaked doesn't make you invisible. It helps you stop broadcasting your financial life to everyone else.

Cloaked is not a mixer, exchange, or custodial wallet. You always control your funds.

Fresh receive addresses reduce address reuse. Incognito balances use compliant privacy pools to break the direct link between receiving and spending funds.

Cloaked improves your privacy, but it does not guarantee anonymity, erase blockchain history, or make public blockchains private. To provide a smooth experience, Cloaked helps coordinate your account activity and balances. Cloaked can see the activity it coordinates, but that activity does not have to be broadcast to everyone else.

### How It Works

See [How It Works](/docs/how-it-works) for the technical model behind fresh addresses, key separation, and sends.

### Safety

See [Safety & Bug Bounty](/docs/safety-and-bug-bounty) for Porto audit and bug bounty information for the account contracts Cloaked uses.


## How It Works

Cloaked gives users fresh receive addresses while keeping one usable wallet experience.

Cloaked is self-custodial. It can generate addresses, scan the chain, track balances, and prepare transactions for you, but only you can sign and move funds.

This is achieved using a capability-based key derivation model.

### Key Derivation Model

When you register, a high-entropy secret is produced on your device — either from a passkey (via biometric prompt) or from a wallet signature protected by a [PIN](/docs/faq#what-is-the-pin). On the client, this secret is deterministically transformed into two **scoped cryptographic capabilities**:

* **Viewing capability**\
  Shared with the service. Allows detection of which stealth addresses belong to you, enables balance tracking, and allows the service to derive new stealth addresses.

* **Spending capability**\
  Retained entirely by the client. Required to authorize and sign transactions from stealth addresses.

These capabilities are not wallet private keys. They are derived, scoped, and re-derivable from your original secret (passkey or wallet signature). Only you can authorize spending. The spending capability never leaves your device.

This separation allows the service to coordinate stealth addresses on your behalf without custody or signing authority.

### Receiving Funds

When someone sends you funds, they can use the Cloaked [ENS](https://ens.domains/) name you choose during setup, a linked ENS name you own, or a payment address generated through the app or API.

Behind the scenes, the service:

* Derives a unique stealth address for each payment
* Monitors the blockchain for funds sent to that address
* Aggregates balances across all stealth addresses associated with you

Each payment lands at a distinct onchain address. That keeps different receives from automatically sharing one reused public address.

Senders never see your other stealth addresses, past or future.

<details>
  <summary><h3>Advanced</h3></summary>

  ##### Stealth Address Derivation

  Stealth addresses are derived using elliptic-curve Diffie–Hellman (ECDH), following the principles described in [ERC-5564](https://eips.ethereum.org/EIPS/eip-5564) and related implementations (e.g. Umbra).

  Address creation requires only public data derived from your spending and viewing keys. No private keys are shared with senders.

  In Cloaked’s architecture, address derivation and scanning are handled off-device for performance and UX, while spending authority remains entirely client-side.
</details>

### Sending Funds

Stealth addresses fragment your balance across many independent addresses. Sending funds requires safely recombining those balances.

At a high level, the service:

* Selects funds from one or more stealth addresses
* Constructs a transaction covering the send amount and fees
* Routes any change to a newly derived stealth address to avoid reuse

Your self-custody wallet authorizes and signs all transactions.

If one send uses multiple addresses, that transaction links those addresses onchain. Cloaked normally optimizes automatically, but where Advanced Control is enabled, users can choose exact address-held balances before requesting a quote.

<details>
  <summary><h3>Advanced</h3></summary>

  Cloaked uses [EIP-7702](https://eips.ethereum.org/EIPS/eip-7702) to upgrade stealth EOAs into [Porto](https://porto.sh/) smart accounts, imbuing Cloaked stealth addresses with the flexibility of smart accounts such as in-kind gas sponsorship and support for operations like swaps and bridging. This makes it practical to combine funds from many stealth addresses into a single send while preserving privacy and avoiding address reuse. All execution is explicitly authorized by the user’s wallet, while the service handles transaction coordination without requiring the user to deploy or manage smart contracts.
</details>

### What Is Visible Onchain

Fresh receives do not hide every blockchain event. They avoid building everything on one address.

| Visible event               | What it means                                          |
| --------------------------- | ------------------------------------------------------ |
| Receive to a fresh address  | Funds arrived at an address generated for your account |
| Balance at that address     | That address holds funds until you spend or move them  |
| Send from one address       | That address paid the destination                      |
| Send from several addresses | Those addresses are linked by the transaction          |
| Change output               | Leftover funds are routed to a new generated address   |

The privacy boundary is practical separation. Fresh addresses help keep unrelated activity apart until user behavior or a later transaction connects it.

### Privacy Pools

Cloaked integrates [Privacy Pools](https://docs.privacypools.com/) to offer an additional layer of privacy. By depositing funds into a compliant privacy pool, your balance is grouped with other deposits. After compliance approval, you can send or swap from your Incognito balance. Note that while the on-chain link to your original deposit is broken, Cloaked's relay service has visibility into both sides of the transaction.

See [Privacy Pools](/docs/privacy-pools) for a full explanation of how pooling works, the balance tiers, and the trust model.


{/* Auto-generated by scripts/generate-api-reference.ts — DO NOT EDIT */}

import { ServerSelector, BearerTokenInput } from '../../components/api-reference/AuthPanel';
import { EndpointCard } from '../../components/api-reference/EndpointCard';

## API Reference

<a href="/openapi.json" target="_blank" style={{ display: 'inline-flex', alignItems: 'center', gap: '8px', padding: '8px 16px', borderRadius: '6px', border: '1px solid var(--vocs-color_border)', fontSize: '14px', textDecoration: 'none', color: 'var(--vocs-color_text2)', marginBottom: '24px' }}>
  Download OpenAPI Spec
</a>

<ServerSelector />

### Authentication

The API accepts two types of Bearer tokens:

* **JWT** — Obtain one instantly by completing the Sign-In with Ethereum (SIWE) flow below (GET /nonce → POST /verify). JWTs are short-lived session tokens.
* **API Key** — Long-lived platform keys for server-to-server integrations. Contact us at [support@clkd.xyz](mailto\:support@clkd.xyz) to request one.

Pass either token in the `Authorization` header — the server auto-detects the format.

**Important:** The address used for authentication must be the address derived from your private spending key (`privateKeyToAccount(p_spend)`), NOT your connected wallet address. The server identity is this derived auth address — your wallet address never touches the server.

Endpoints marked with 🔒 require a valid Bearer token.

<BearerTokenInput />

#### Get HPKE public key

<EndpointCard data={{"method":"GET","path":"/v1/.well-known/hpke-public-key","operationId":"getHpkePublicKey","tags":["Authentication"],"description":"Retrieve the server's HPKE public key. Clients must encrypt stealth key material with this key before submitting it during account creation or signer enrollment.","parameters":[],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"publicKey":{"example":"0x...","type":"string"},"publicKeyBase64":{"example":"...","type":"string"},"format":{"example":"hex","type":"string"},"kem":{"example":"X25519-HKDF-SHA256","type":"string"},"aead":{"example":"AES-128-GCM","type":"string"}},"required":["publicKey","publicKeyBase64","format","kem","aead"]}}],"requiresAuth":false}} />

#### Get nonce

<EndpointCard data={{"method":"GET","path":"/v1/nonce","operationId":"getNonce","tags":["Authentication"],"description":"Generate a one-time nonce tied to the given address. This is the first step of Sign-In with Ethereum (SIWE) — the nonce must be included in the SIWE message passed to verifySignin. Nonces expire after 5 minutes.","parameters":[{"schema":{"type":"string"},"in":"query","name":"address","required":true,"description":"The auth address to tie the nonce to. This must be the address derived from your private spending key (i.e. `privateKeyToAccount(p_spend).address`), not your connected wallet address."}],"responses":[{"status":"200","description":"Random nonce string","schema":{"type":"string","description":"Random nonce string","example":"a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"429","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Too Many Requests","type":"string"},"message":{"example":"Rate limit exceeded. Maximum 20 requests per 1 minute.","type":"string"}},"required":["error","message"]}}],"requiresAuth":false}} />

#### Verify sign-in

<EndpointCard data={{"method":"POST","path":"/v1/verify","operationId":"verifySignin","tags":["Authentication"],"description":"Complete Sign-In with Ethereum by submitting the signed SIWE message. Returns a JWT session token and the associated accountId if the address already has an account, or null if the user still needs to register.","parameters":[],"requestBody":{"required":true,"schema":{"additionalProperties":false,"type":"object","properties":{"message":{"description":"SIWE message string","type":"string"},"signature":{"description":"Signature from wallet","type":"string"},"authType":{"maxLength":64,"pattern":"^[a-z][a-z0-9_]{0,63}$","description":"Optional lowercase snake_case auth mechanism label, e.g. passkey_prf or wallet_pin.","type":"string"}},"required":["message","signature"]}},"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"ok":{"example":true,"type":"boolean"},"address":{"example":"0x...","type":"string"},"token":{"description":"JWT authentication token","type":"string"},"accountId":{"description":"Account ID if user is registered, null otherwise","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["ok","address","token","accountId"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"422","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unprocessable Entity","type":"string"},"message":{"type":"string"},"code":{"example":"UNPROCESSABLE_ENTITY","type":"string"}},"required":["error","message"]}},{"status":"429","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Too Many Requests","type":"string"},"message":{"example":"Rate limit exceeded. Maximum 10 requests per 1 minute.","type":"string"}},"required":["error","message"]}}],"requiresAuth":false}} />

#### Logout

<EndpointCard data={{"method":"POST","path":"/v1/logout","operationId":"logout","tags":["Authentication"],"description":"Clear the server-side cache for the authenticated user. JWT tokens are stateless, so the client should also discard the token. Auth is optional — unauthenticated calls succeed without clearing any cache.","parameters":[],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"ok":{"example":true,"type":"boolean"}},"required":["ok"]}}],"requiresAuth":false}} />

### Account Management

Account creation, signers, subdomains, and setup

#### Check subdomain availability

<EndpointCard data={{"method":"GET","path":"/v1/subdomain/check","operationId":"checkSubdomainAvailability","tags":["Account Management"],"description":"Check whether a subdomain name is available for registration. Public endpoint — no authentication required. Use before calling setSubdomain to avoid conflicts.","parameters":[{"schema":{"minLength":1,"type":"string"},"in":"query","name":"name","required":true},{"schema":{"type":"string"},"in":"query","name":"inviteCode","required":false}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"type":"string","enum":["taken"]},{"type":"string","enum":["blocked"]}]}},"required":["available"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}}],"requiresAuth":false}} />

#### Create account

<EndpointCard data={{"method":"POST","path":"/v1/accounts/","operationId":"createAccount","tags":["Account Management"],"description":"Register a new account by submitting HPKE-encrypted key material. The caller must already have a JWT from the SIWE sign-in flow, which proves ownership of the Ethereum address. The server decrypts and stores the keys, enabling payment address generation for this account. Requires an invite code when gated access is enabled. Returns the new accountId, or indicates if the address already has an account.","parameters":[],"requestBody":{"required":true,"schema":{"additionalProperties":false,"type":"object","properties":{"ciphertext":{"description":"Base64-encoded encrypted payload","type":"string"},"encapsulatedKey":{"description":"Base64-encoded HPKE encapsulated key","type":"string"},"inviteCode":{"description":"Invite code for gated access","type":"string"},"onboardingExperimentId":{"format":"uuid","type":"string"},"experimentKey":{"maxLength":64,"type":"string"},"variantKey":{"maxLength":64,"type":"string"}},"required":["ciphertext","encapsulatedKey"]}},"responses":[{"status":"201","description":"Default Response","schema":{"type":"object","properties":{"accountId":{"description":"Created account ID (null if already existed)","anyOf":[{"type":"string"},{"type":"null"}]},"alreadyExisted":{"type":"boolean"}},"required":["accountId","alreadyExisted"]}}],"requiresAuth":true}} />

#### Get account

<EndpointCard data={{"method":"GET","path":"/v1/accounts/{accountId}","operationId":"getAccount","tags":["Account Management"],"description":"Retrieve account metadata including the owner address, registration status, and ENS subdomain. Useful for determining onboarding state (e.g., whether the user still needs to claim a subdomain).","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"accountId":{"type":"string"},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"isRegistered":{"type":"boolean"},"createdAt":{"description":"Timestamp when the account was created.","anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"subdomain":{"anyOf":[{"type":"string"},{"type":"null"}]},"encryptedCustomEnsName":{"anyOf":[{"type":"string"},{"type":"null"}]},"activationOfferClaimExpiresAt":{"description":"Timestamp when the new-user activation offer can no longer be claimed.","anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"lastConsumedNonce":{"description":"Last consumed stealth address nonce (0-indexed). null if no addresses generated yet.","anyOf":[{"type":"number"},{"type":"null"}]},"cloakie":{"anyOf":[{"type":"object","properties":{"active":{"type":"boolean"},"deposits":{"type":"array","items":{"type":"object","properties":{"tokenId":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"depositAddress":{"type":"string"}},"required":["tokenId","imageUrl","depositAddress"]}}},"required":["active","deposits"]},{"type":"null"}]},"hasPoolDeposits":{"description":"True if the account has any pool commitment rows. Used to trigger eager pool balance discovery at login.","type":"boolean"}},"required":["accountId","address","isRegistered","createdAt","subdomain","encryptedCustomEnsName","activationOfferClaimExpiresAt","lastConsumedNonce"]}}],"requiresAuth":true}} />

#### Get funded addresses

<EndpointCard data={{"method":"GET","path":"/v1/accounts/{accountId}/funded-addresses","operationId":"getFundedAddresses","tags":["Account Management"],"description":"Deprecated. Use GET /address-balances instead.","parameters":[{"schema":{"type":"string"},"in":"query","name":"dappOrigin","required":false,"description":"Filter recently-used addresses by this dApp origin"},{"schema":{"minimum":1,"maximum":100,"type":"number"},"in":"query","name":"limit","required":false,"description":"Max addresses to return. Omit to return all (legacy behavior)."},{"schema":{"minimum":0,"default":0,"type":"number"},"in":"query","name":"offset","required":false},{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"addresses":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"nonce":{"type":"string"},"usedOrigins":{"type":"array","items":{"type":"string"}},"recentlyUsedByDapp":{"type":"boolean"},"totalUsdBalance":{"anyOf":[{"type":"number"},{"type":"null"}]},"balances":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"chainName":{"type":"string"},"token":{"type":"string"},"tokenSymbol":{"type":"string"},"decimals":{"type":"number"},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"amount":{"description":"Raw amount in smallest unit","type":"string"},"available":{"description":"Unspent raw amount in smallest unit","type":"string"},"pending":{"description":"Locked raw amount in smallest unit","type":"string"},"usdAmount":{"anyOf":[{"type":"number"},{"type":"null"}]},"pricePerToken":{"anyOf":[{"type":"number"},{"type":"null"}]},"priceStale":{"type":"boolean"}},"required":["chainId","chainName","token","tokenSymbol","decimals","logoUrl","amount","available","pending","usdAmount","pricePerToken","priceStale"]}}},"required":["address","nonce","usedOrigins","recentlyUsedByDapp","totalUsdBalance","balances"]}},"total":{"description":"Total number of funded addresses before pagination","type":"number"}},"required":["addresses","total"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}},{"status":"403","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Forbidden","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"429","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Too Many Requests","type":"string"},"message":{"example":"Rate limit exceeded. Maximum 60 requests per 1 minute.","type":"string"}},"required":["error","message"]}},{"status":"503","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Service Unavailable","type":"string"},"message":{"type":"string"},"code":{"example":"SERVER_BUSY","description":"Machine-readable reason, such as SERVER_BUSY or POOL_STATE_REFRESHING.","type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### List account tokens

<EndpointCard data={{"method":"GET","path":"/v1/accounts/{accountId}/tokens","operationId":"listAccountTokens","tags":["Account Management"],"description":"List active token imports for the authenticated account.","parameters":[{"schema":{"type":"string"},"in":"query","name":"include","required":false,"description":"Comma-separated optional enrichments. Supported values: market,sources."},{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"tokens":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"decimals":{"type":"number"},"chainId":{"type":"number"},"logoURI":{"type":"string"},"isClanker":{"type":"boolean"},"visibility":{"type":"string"},"metadataSource":{"type":"string"},"market":{"anyOf":[{"type":"object","properties":{"provider":{"type":"string"},"providerAssetId":{"type":"string"},"vsCurrency":{"type":"string"},"price":{"anyOf":[{"type":"string"},{"type":"null"}]},"marketCap":{"anyOf":[{"type":"string"},{"type":"null"}]},"marketCapRank":{"anyOf":[{"type":"number"},{"type":"null"}]},"fullyDilutedValuation":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalVolume":{"anyOf":[{"type":"string"},{"type":"null"}]},"high24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"low24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"priceChange24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"priceChangePercentage24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"marketCapChange24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"marketCapChangePercentage24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"circulatingSupply":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalSupply":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxSupply":{"anyOf":[{"type":"string"},{"type":"null"}]},"ath":{"anyOf":[{"type":"string"},{"type":"null"}]},"athChangePercentage":{"anyOf":[{"type":"string"},{"type":"null"}]},"athDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"atl":{"anyOf":[{"type":"string"},{"type":"null"}]},"atlChangePercentage":{"anyOf":[{"type":"string"},{"type":"null"}]},"atlDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerUpdatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"fetchedAt":{"type":"string"},"stale":{"type":"boolean"}},"required":["provider","providerAssetId","vsCurrency","price","marketCap","marketCapRank","fullyDilutedValuation","totalVolume","high24h","low24h","priceChange24h","priceChangePercentage24h","marketCapChange24h","marketCapChangePercentage24h","circulatingSupply","totalSupply","maxSupply","ath","athChangePercentage","athDate","atl","atlChangePercentage","atlDate","providerUpdatedAt","fetchedAt","stale"]},{"type":"null"}]},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"sourceId":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"number"},"logoUrl":{"type":"string"},"externalUrl":{"type":"string"},"firstSeenAt":{"type":"string"},"lastSeenAt":{"type":"string"}},"required":["source","sourceId","firstSeenAt","lastSeenAt"]}}},"required":["address","symbol","name","decimals","chainId"]}}},"required":["tokens"]}},{"status":"404","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Not found","type":"string"},"message":{"type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### Import account token

<EndpointCard data={{"method":"POST","path":"/v1/accounts/{accountId}/tokens","operationId":"importAccountToken","tags":["Account Management"],"description":"Import an allowed canonical token for the authenticated account.","parameters":[{"schema":{"type":"string"},"in":"query","name":"include","required":false,"description":"Comma-separated optional enrichments. Supported values: market,sources."},{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"requestBody":{"required":true,"schema":{"type":"object","properties":{"chainId":{"type":"number"},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},"required":["chainId","address"]}},"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"token":{"type":"object","properties":{"address":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"decimals":{"type":"number"},"chainId":{"type":"number"},"logoURI":{"type":"string"},"isClanker":{"type":"boolean"},"visibility":{"type":"string"},"metadataSource":{"type":"string"},"market":{"anyOf":[{"type":"object","properties":{"provider":{"type":"string"},"providerAssetId":{"type":"string"},"vsCurrency":{"type":"string"},"price":{"anyOf":[{"type":"string"},{"type":"null"}]},"marketCap":{"anyOf":[{"type":"string"},{"type":"null"}]},"marketCapRank":{"anyOf":[{"type":"number"},{"type":"null"}]},"fullyDilutedValuation":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalVolume":{"anyOf":[{"type":"string"},{"type":"null"}]},"high24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"low24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"priceChange24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"priceChangePercentage24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"marketCapChange24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"marketCapChangePercentage24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"circulatingSupply":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalSupply":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxSupply":{"anyOf":[{"type":"string"},{"type":"null"}]},"ath":{"anyOf":[{"type":"string"},{"type":"null"}]},"athChangePercentage":{"anyOf":[{"type":"string"},{"type":"null"}]},"athDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"atl":{"anyOf":[{"type":"string"},{"type":"null"}]},"atlChangePercentage":{"anyOf":[{"type":"string"},{"type":"null"}]},"atlDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerUpdatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"fetchedAt":{"type":"string"},"stale":{"type":"boolean"}},"required":["provider","providerAssetId","vsCurrency","price","marketCap","marketCapRank","fullyDilutedValuation","totalVolume","high24h","low24h","priceChange24h","priceChangePercentage24h","marketCapChange24h","marketCapChangePercentage24h","circulatingSupply","totalSupply","maxSupply","ath","athChangePercentage","athDate","atl","atlChangePercentage","atlDate","providerUpdatedAt","fetchedAt","stale"]},{"type":"null"}]},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"sourceId":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"number"},"logoUrl":{"type":"string"},"externalUrl":{"type":"string"},"firstSeenAt":{"type":"string"},"lastSeenAt":{"type":"string"}},"required":["source","sourceId","firstSeenAt","lastSeenAt"]}}},"required":["address","symbol","name","decimals","chainId"]}},"required":["token"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"403","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Forbidden","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"404","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Not found","type":"string"},"message":{"type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### Get account token detail

<EndpointCard data={{"method":"GET","path":"/v1/accounts/{accountId}/tokens/{chainId}/{address}","operationId":"getAccountTokenDetail","tags":["Account Management"],"description":"Return canonical token metadata and this account’s balance for one token. Use include=market,sources to attach current market data and provider provenance.","parameters":[{"schema":{"type":"string"},"in":"query","name":"include","required":false,"description":"Comma-separated optional enrichments. Supported values: market,sources."},{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"},{"schema":{"type":"string"},"in":"path","name":"chainId","required":true,"description":"Chain ID"},{"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"in":"path","name":"address","required":true,"description":"Token contract address"}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"token":{"type":"object","properties":{"address":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"decimals":{"type":"number"},"chainId":{"type":"number"},"logoURI":{"type":"string"},"isClanker":{"type":"boolean"},"visibility":{"type":"string"},"metadataSource":{"type":"string"},"market":{"anyOf":[{"type":"object","properties":{"provider":{"type":"string"},"providerAssetId":{"type":"string"},"vsCurrency":{"type":"string"},"price":{"anyOf":[{"type":"string"},{"type":"null"}]},"marketCap":{"anyOf":[{"type":"string"},{"type":"null"}]},"marketCapRank":{"anyOf":[{"type":"number"},{"type":"null"}]},"fullyDilutedValuation":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalVolume":{"anyOf":[{"type":"string"},{"type":"null"}]},"high24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"low24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"priceChange24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"priceChangePercentage24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"marketCapChange24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"marketCapChangePercentage24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"circulatingSupply":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalSupply":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxSupply":{"anyOf":[{"type":"string"},{"type":"null"}]},"ath":{"anyOf":[{"type":"string"},{"type":"null"}]},"athChangePercentage":{"anyOf":[{"type":"string"},{"type":"null"}]},"athDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"atl":{"anyOf":[{"type":"string"},{"type":"null"}]},"atlChangePercentage":{"anyOf":[{"type":"string"},{"type":"null"}]},"atlDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerUpdatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"fetchedAt":{"type":"string"},"stale":{"type":"boolean"}},"required":["provider","providerAssetId","vsCurrency","price","marketCap","marketCapRank","fullyDilutedValuation","totalVolume","high24h","low24h","priceChange24h","priceChangePercentage24h","marketCapChange24h","marketCapChangePercentage24h","circulatingSupply","totalSupply","maxSupply","ath","athChangePercentage","athDate","atl","atlChangePercentage","atlDate","providerUpdatedAt","fetchedAt","stale"]},{"type":"null"}]},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"sourceId":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"number"},"logoUrl":{"type":"string"},"externalUrl":{"type":"string"},"firstSeenAt":{"type":"string"},"lastSeenAt":{"type":"string"}},"required":["source","sourceId","firstSeenAt","lastSeenAt"]}}},"required":["address","symbol","name","decimals","chainId"]},"balance":{"description":"Balance for a single token on a single chain. Contains visible available and pending amounts for standard on-chain stealth address holdings.","type":"object","properties":{"chainId":{"example":8453,"description":"Chain ID where this token resides","type":"number"},"chainName":{"example":"Base","description":"Human-readable chain name","type":"string"},"token":{"example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Token contract address (EIP-55 checksummed)","type":"string"},"tokenSymbol":{"example":"USDC","description":"Token ticker symbol","type":"string"},"decimals":{"example":6,"description":"Token decimal places","type":"number"},"logoUrl":{"example":"https://assets.coingecko.com/coins/images/6319/small/usdc.png","description":"Token logo URL, or null if unavailable","anyOf":[{"type":"string"},{"type":"null"}]},"visible":{"description":"Standard on-chain balances held in stealth addresses. These funds have no privacy pool provenance — they arrived via receives, swaps, or on-ramps.","type":"object","properties":{"available":{"example":"1000000","description":"Balance available to spend immediately — not locked by any pending transaction (stringified bigint, smallest unit)","type":"string"},"pending":{"example":"500000","description":"Balance locked by an outbound transaction that has not yet confirmed on-chain (stringified bigint, smallest unit)","type":"string"}},"required":["available","pending"]},"incognito":{"description":"Incognito balances from privacy pools. The server tracks available, pending withdrawal, pending approval, and declined tiers.","type":"object","properties":{"pooled":{"description":"Privacy pool balances. Available is the authoritative withdrawable amount tracked by the server.","type":"object","properties":{"available":{"example":"750000","description":"Sum of ASP-approved, unspent, unlocked commitment values — how much the user can withdraw right now. (stringified bigint, smallest unit)","type":"string"},"pendingApproval":{"example":"250000","description":"Deposits awaiting ASP compliance approval. Will become available automatically once approved. Includes inflight deposits confirmed on-chain but not yet indexed. (stringified bigint, smallest unit)","type":"string"},"pendingWithdrawal":{"example":"500000","description":"ASP-approved pool funds locked by a pending withdrawal. Not available for a new send, but still counted in total balance while the withdrawal confirms. (stringified bigint, smallest unit)","type":"string"},"declined":{"example":"0","description":"Deposits that were not allowed to join the pool by the compliance check. Recoverable back to the visible wallet balance via the recovery flow. Distinct from pendingApproval so clients can prompt the recovery action instead of leaving the user waiting on a state that will never resolve on its own. (stringified bigint, smallest unit)","type":"string"}},"required":["available","pendingApproval","pendingWithdrawal","declined"]}},"required":["pooled"]},"usdAmount":{"example":1.5,"description":"Total USD value of visible balance. Null when pricing data is unavailable for a token that has a non-zero balance.","anyOf":[{"type":"number"},{"type":"null"}]},"pricePerToken":{"example":2000.42,"description":"USD price for one whole token (e.g. 1 ETH). Null when pricing data is unavailable. Use this to compute USD values on the client: amount * pricePerToken.","anyOf":[{"type":"number"},{"type":"null"}]},"priceStale":{"example":false,"description":"True when all live price sources failed and the price was served from an expired cache entry","type":"boolean"},"spam":{"example":false,"description":"True if the token is flagged as potential spam or a phishing token","type":"boolean"}},"required":["chainId","chainName","token","tokenSymbol","decimals","logoUrl","visible","incognito","usdAmount","pricePerToken","priceStale","spam"]}},"required":["token","balance"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"403","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Forbidden","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"404","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Not found","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"429","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Too Many Requests","type":"string"},"message":{"example":"Rate limit exceeded. Maximum 60 requests per 1 minute.","type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### Claim subdomain

<EndpointCard data={{"method":"POST","path":"/v1/accounts/{accountId}/subdomain","operationId":"claimSubdomain","tags":["Account Management"],"description":"Claim an ENS subdomain (e.g. alice.clkd.eth) for this account so senders can pay via a human-readable name instead of a raw address. Each account may claim one subdomain.","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"requestBody":{"required":true,"schema":{"additionalProperties":false,"type":"object","properties":{"subdomain":{"description":"Subdomain name (will be normalized and stored as {subdomain}.clkd.eth)","type":"string"}},"required":["subdomain"]}},"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"},"subdomain":{"type":"string"}},"required":["success","message","subdomain"]}}],"requiresAuth":true}} />

#### Generate subdomain

<EndpointCard data={{"method":"GET","path":"/v1/accounts/{accountId}/subdomain/generate","operationId":"generateSubdomain","tags":["Account Management"],"description":"Generate a random available subdomain for the user to preview during onboarding. The name is not reserved — call setSubdomain to claim it.","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"subdomain":{"example":"example-123.clkd.eth","type":"string"}},"required":["subdomain"]}}],"requiresAuth":true}} />

### Receive

Payment address generation and ENS resolution

#### Create payment address

<EndpointCard data={{"method":"POST","path":"/v1/accounts/{accountId}/payment-address","operationId":"createPaymentAddress","tags":["Receive"],"description":"Derive a one-time payment address so a sender can transfer tokens to this account without revealing the recipient on-chain.","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"},{"schema":{"type":"string"},"in":"header","name":"idempotency-key","required":false,"description":"Client-generated unique key (e.g. UUID). If the server has already processed a request with this key for the same account and body, it returns the cached response instead of re-executing. Keys expire after 24 hours."}],"requestBody":{"required":false,"schema":{"additionalProperties":false,"type":"object","properties":{}}},"responses":[{"status":"201","description":"Default Response","schema":{"type":"object","properties":{"address":{"type":"string"},"nonce":{"description":"Nonce used for derivation (stringified bigint)","type":"string"},"reused":{"description":"True when the daily limit is reached and a previously-issued address is served instead of a fresh one.","type":"boolean"},"limitResetsAt":{"description":"ISO timestamp (next UTC midnight) when fresh addresses become available again. Present only when reused is true.","type":"string"}},"required":["address","nonce"]}}],"requiresAuth":true}} />

### Balance & Activity

Balance queries, transaction history, and supported tokens

#### List supported chains

<EndpointCard data={{"method":"GET","path":"/v1/supported-chains","operationId":"listSupportedChains","tags":["Balance & Activity"],"description":"List every chain the platform supports, including explorer URLs, logo base names, and testnet/mainnet mapping. Use to populate chain pickers or build explorer links.","parameters":[],"responses":[{"status":"200","description":"Default Response","schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"chainId":{"type":"number"},"isTestnet":{"type":"boolean"},"explorerUrl":{"type":"string"},"explorerTxPath":{"type":"string"},"mainnetChainId":{"type":"number"},"logoBaseName":{"type":"string"},"isSquareLogo":{"type":"boolean"}},"required":["name","chainId","isTestnet","explorerUrl","explorerTxPath","mainnetChainId","logoBaseName","isSquareLogo"]}}}],"requiresAuth":false}} />

#### Get token catalog

<EndpointCard data={{"method":"GET","path":"/v1/token-catalog","operationId":"getTokenCatalog","tags":["Balance & Activity"],"description":"Return the supported token catalog, pinned symbols for the swap picker, and testnet-to-mainnet chain-ID mapping.","parameters":[{"schema":{"type":"string"},"in":"query","name":"q","required":false},{"schema":{"type":"number"},"in":"query","name":"chainId","required":false},{"schema":{"minimum":1,"maximum":1000,"type":"number"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"include","required":false,"description":"Comma-separated optional enrichments. Supported values: market,sources."}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"tokens":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"decimals":{"type":"number"},"chainId":{"type":"number"},"logoURI":{"type":"string"},"isClanker":{"type":"boolean"},"visibility":{"type":"string"},"metadataSource":{"type":"string"},"market":{"anyOf":[{"type":"object","properties":{"provider":{"type":"string"},"providerAssetId":{"type":"string"},"vsCurrency":{"type":"string"},"price":{"anyOf":[{"type":"string"},{"type":"null"}]},"marketCap":{"anyOf":[{"type":"string"},{"type":"null"}]},"marketCapRank":{"anyOf":[{"type":"number"},{"type":"null"}]},"fullyDilutedValuation":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalVolume":{"anyOf":[{"type":"string"},{"type":"null"}]},"high24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"low24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"priceChange24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"priceChangePercentage24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"marketCapChange24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"marketCapChangePercentage24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"circulatingSupply":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalSupply":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxSupply":{"anyOf":[{"type":"string"},{"type":"null"}]},"ath":{"anyOf":[{"type":"string"},{"type":"null"}]},"athChangePercentage":{"anyOf":[{"type":"string"},{"type":"null"}]},"athDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"atl":{"anyOf":[{"type":"string"},{"type":"null"}]},"atlChangePercentage":{"anyOf":[{"type":"string"},{"type":"null"}]},"atlDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerUpdatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"fetchedAt":{"type":"string"},"stale":{"type":"boolean"}},"required":["provider","providerAssetId","vsCurrency","price","marketCap","marketCapRank","fullyDilutedValuation","totalVolume","high24h","low24h","priceChange24h","priceChangePercentage24h","marketCapChange24h","marketCapChangePercentage24h","circulatingSupply","totalSupply","maxSupply","ath","athChangePercentage","athDate","atl","atlChangePercentage","atlDate","providerUpdatedAt","fetchedAt","stale"]},{"type":"null"}]},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"sourceId":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"number"},"logoUrl":{"type":"string"},"externalUrl":{"type":"string"},"firstSeenAt":{"type":"string"},"lastSeenAt":{"type":"string"}},"required":["source","sourceId","firstSeenAt","lastSeenAt"]}}},"required":["address","symbol","name","decimals","chainId"]}},"pinnedSymbols":{"type":"array","items":{"type":"string"}},"testnetToMainnet":{"type":"object","additionalProperties":{"type":"number"}},"nextCursor":{"type":"string"}},"required":["tokens","pinnedSymbols","testnetToMainnet"]}}],"requiresAuth":false}} />

#### Lookup token

<EndpointCard data={{"method":"GET","path":"/v1/token-lookup","operationId":"lookupToken","tags":["Balance & Activity"],"description":"Look up token metadata by contract address. Checks cached sources first, then queries the Clanker API and on-chain ERC-20 metadata.","parameters":[{"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"in":"query","name":"address","required":true},{"schema":{"type":"number"},"in":"query","name":"chainId","required":true},{"schema":{"type":"string"},"in":"query","name":"include","required":false,"description":"Comma-separated optional enrichments. Supported values: market,sources."}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"address":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"decimals":{"type":"number"},"chainId":{"type":"number"},"logoURI":{"type":"string"},"isClanker":{"type":"boolean"},"visibility":{"type":"string"},"metadataSource":{"type":"string"},"market":{"anyOf":[{"type":"object","properties":{"provider":{"type":"string"},"providerAssetId":{"type":"string"},"vsCurrency":{"type":"string"},"price":{"anyOf":[{"type":"string"},{"type":"null"}]},"marketCap":{"anyOf":[{"type":"string"},{"type":"null"}]},"marketCapRank":{"anyOf":[{"type":"number"},{"type":"null"}]},"fullyDilutedValuation":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalVolume":{"anyOf":[{"type":"string"},{"type":"null"}]},"high24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"low24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"priceChange24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"priceChangePercentage24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"marketCapChange24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"marketCapChangePercentage24h":{"anyOf":[{"type":"string"},{"type":"null"}]},"circulatingSupply":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalSupply":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxSupply":{"anyOf":[{"type":"string"},{"type":"null"}]},"ath":{"anyOf":[{"type":"string"},{"type":"null"}]},"athChangePercentage":{"anyOf":[{"type":"string"},{"type":"null"}]},"athDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"atl":{"anyOf":[{"type":"string"},{"type":"null"}]},"atlChangePercentage":{"anyOf":[{"type":"string"},{"type":"null"}]},"atlDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerUpdatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"fetchedAt":{"type":"string"},"stale":{"type":"boolean"}},"required":["provider","providerAssetId","vsCurrency","price","marketCap","marketCapRank","fullyDilutedValuation","totalVolume","high24h","low24h","priceChange24h","priceChangePercentage24h","marketCapChange24h","marketCapChangePercentage24h","circulatingSupply","totalSupply","maxSupply","ath","athChangePercentage","athDate","atl","atlChangePercentage","atlDate","providerUpdatedAt","fetchedAt","stale"]},{"type":"null"}]},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"sourceId":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"number"},"logoUrl":{"type":"string"},"externalUrl":{"type":"string"},"firstSeenAt":{"type":"string"},"lastSeenAt":{"type":"string"}},"required":["source","sourceId","firstSeenAt","lastSeenAt"]}}},"required":["address","symbol","name","decimals","chainId"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"404","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Not found","type":"string"},"message":{"type":"string"}},"required":["error","message"]}}],"requiresAuth":false}} />

#### Get balances

<EndpointCard data={{"method":"GET","path":"/v1/accounts/{accountId}/balance","operationId":"getBalances","tags":["Balance & Activity"],"description":"Retrieve token balances across every supported chain for this account. Each balance contains visible (standard on-chain) available and pending amounts. Returns a totalUsdAmount summarizing all holdings.","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"balances":{"description":"One entry per token per chain, each with tiered balance breakdown","type":"array","items":{"description":"Balance for a single token on a single chain. Contains visible available and pending amounts for standard on-chain stealth address holdings.","type":"object","properties":{"chainId":{"example":8453,"description":"Chain ID where this token resides","type":"number"},"chainName":{"example":"Base","description":"Human-readable chain name","type":"string"},"token":{"example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Token contract address (EIP-55 checksummed)","type":"string"},"tokenSymbol":{"example":"USDC","description":"Token ticker symbol","type":"string"},"decimals":{"example":6,"description":"Token decimal places","type":"number"},"logoUrl":{"example":"https://assets.coingecko.com/coins/images/6319/small/usdc.png","description":"Token logo URL, or null if unavailable","anyOf":[{"type":"string"},{"type":"null"}]},"visible":{"description":"Standard on-chain balances held in stealth addresses. These funds have no privacy pool provenance — they arrived via receives, swaps, or on-ramps.","type":"object","properties":{"available":{"example":"1000000","description":"Balance available to spend immediately — not locked by any pending transaction (stringified bigint, smallest unit)","type":"string"},"pending":{"example":"500000","description":"Balance locked by an outbound transaction that has not yet confirmed on-chain (stringified bigint, smallest unit)","type":"string"}},"required":["available","pending"]},"incognito":{"description":"Incognito balances from privacy pools. The server tracks available, pending withdrawal, pending approval, and declined tiers.","type":"object","properties":{"pooled":{"description":"Privacy pool balances. Available is the authoritative withdrawable amount tracked by the server.","type":"object","properties":{"available":{"example":"750000","description":"Sum of ASP-approved, unspent, unlocked commitment values — how much the user can withdraw right now. (stringified bigint, smallest unit)","type":"string"},"pendingApproval":{"example":"250000","description":"Deposits awaiting ASP compliance approval. Will become available automatically once approved. Includes inflight deposits confirmed on-chain but not yet indexed. (stringified bigint, smallest unit)","type":"string"},"pendingWithdrawal":{"example":"500000","description":"ASP-approved pool funds locked by a pending withdrawal. Not available for a new send, but still counted in total balance while the withdrawal confirms. (stringified bigint, smallest unit)","type":"string"},"declined":{"example":"0","description":"Deposits that were not allowed to join the pool by the compliance check. Recoverable back to the visible wallet balance via the recovery flow. Distinct from pendingApproval so clients can prompt the recovery action instead of leaving the user waiting on a state that will never resolve on its own. (stringified bigint, smallest unit)","type":"string"}},"required":["available","pendingApproval","pendingWithdrawal","declined"]}},"required":["pooled"]},"usdAmount":{"example":1.5,"description":"Total USD value of visible balance. Null when pricing data is unavailable for a token that has a non-zero balance.","anyOf":[{"type":"number"},{"type":"null"}]},"pricePerToken":{"example":2000.42,"description":"USD price for one whole token (e.g. 1 ETH). Null when pricing data is unavailable. Use this to compute USD values on the client: amount * pricePerToken.","anyOf":[{"type":"number"},{"type":"null"}]},"priceStale":{"example":false,"description":"True when all live price sources failed and the price was served from an expired cache entry","type":"boolean"},"spam":{"example":false,"description":"True if the token is flagged as potential spam or a phishing token","type":"boolean"}},"required":["chainId","chainName","token","tokenSymbol","decimals","logoUrl","visible","incognito","usdAmount","pricePerToken","priceStale","spam"]}},"totalUsdAmount":{"example":1.5,"description":"Sum of usdAmount across all balance items. Null when no pricing data is available for any token.","anyOf":[{"type":"number"},{"type":"null"}]},"feeWaiver":{"type":"object","properties":{"active":{"description":"True when Cloaked service fees are currently waived for this account.","type":"boolean"},"source":{"description":"Why fees are waived. activation is the time-limited new-user activation offer; cloakie is the NFT waiver.","anyOf":[{"type":"string","enum":["activation"]},{"type":"string","enum":["cloakie"]},{"type":"null"}]},"activeUntil":{"description":"Expiry timestamp for time-limited waivers. Null for non-expiring waivers.","anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["active","source","activeUntil"]}},"required":["balances","totalUsdAmount","feeWaiver"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}},{"status":"404","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Not found","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"429","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Too Many Requests","type":"string"},"message":{"example":"Rate limit exceeded. Maximum 60 requests per 1 minute.","type":"string"}},"required":["error","message"]}},{"status":"503","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Service Unavailable","type":"string"},"message":{"type":"string"},"code":{"example":"SERVER_BUSY","description":"Machine-readable reason, such as SERVER_BUSY or POOL_STATE_REFRESHING.","type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### Get chain balances

<EndpointCard data={{"method":"GET","path":"/v1/accounts/{accountId}/balance/{chainId}","operationId":"getChainBalances","tags":["Balance & Activity"],"description":"Retrieve token balances filtered to a single chain. Same response shape as getBalances (visible available/pending) but scoped to the given chainId.","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"},{"schema":{"type":"string"},"in":"path","name":"chainId","required":true,"description":"Chain ID (e.g., 8453 for Base)"}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"balances":{"description":"One entry per token per chain, each with tiered balance breakdown","type":"array","items":{"description":"Balance for a single token on a single chain. Contains visible available and pending amounts for standard on-chain stealth address holdings.","type":"object","properties":{"chainId":{"example":8453,"description":"Chain ID where this token resides","type":"number"},"chainName":{"example":"Base","description":"Human-readable chain name","type":"string"},"token":{"example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Token contract address (EIP-55 checksummed)","type":"string"},"tokenSymbol":{"example":"USDC","description":"Token ticker symbol","type":"string"},"decimals":{"example":6,"description":"Token decimal places","type":"number"},"logoUrl":{"example":"https://assets.coingecko.com/coins/images/6319/small/usdc.png","description":"Token logo URL, or null if unavailable","anyOf":[{"type":"string"},{"type":"null"}]},"visible":{"description":"Standard on-chain balances held in stealth addresses. These funds have no privacy pool provenance — they arrived via receives, swaps, or on-ramps.","type":"object","properties":{"available":{"example":"1000000","description":"Balance available to spend immediately — not locked by any pending transaction (stringified bigint, smallest unit)","type":"string"},"pending":{"example":"500000","description":"Balance locked by an outbound transaction that has not yet confirmed on-chain (stringified bigint, smallest unit)","type":"string"}},"required":["available","pending"]},"incognito":{"description":"Incognito balances from privacy pools. The server tracks available, pending withdrawal, pending approval, and declined tiers.","type":"object","properties":{"pooled":{"description":"Privacy pool balances. Available is the authoritative withdrawable amount tracked by the server.","type":"object","properties":{"available":{"example":"750000","description":"Sum of ASP-approved, unspent, unlocked commitment values — how much the user can withdraw right now. (stringified bigint, smallest unit)","type":"string"},"pendingApproval":{"example":"250000","description":"Deposits awaiting ASP compliance approval. Will become available automatically once approved. Includes inflight deposits confirmed on-chain but not yet indexed. (stringified bigint, smallest unit)","type":"string"},"pendingWithdrawal":{"example":"500000","description":"ASP-approved pool funds locked by a pending withdrawal. Not available for a new send, but still counted in total balance while the withdrawal confirms. (stringified bigint, smallest unit)","type":"string"},"declined":{"example":"0","description":"Deposits that were not allowed to join the pool by the compliance check. Recoverable back to the visible wallet balance via the recovery flow. Distinct from pendingApproval so clients can prompt the recovery action instead of leaving the user waiting on a state that will never resolve on its own. (stringified bigint, smallest unit)","type":"string"}},"required":["available","pendingApproval","pendingWithdrawal","declined"]}},"required":["pooled"]},"usdAmount":{"example":1.5,"description":"Total USD value of visible balance. Null when pricing data is unavailable for a token that has a non-zero balance.","anyOf":[{"type":"number"},{"type":"null"}]},"pricePerToken":{"example":2000.42,"description":"USD price for one whole token (e.g. 1 ETH). Null when pricing data is unavailable. Use this to compute USD values on the client: amount * pricePerToken.","anyOf":[{"type":"number"},{"type":"null"}]},"priceStale":{"example":false,"description":"True when all live price sources failed and the price was served from an expired cache entry","type":"boolean"},"spam":{"example":false,"description":"True if the token is flagged as potential spam or a phishing token","type":"boolean"}},"required":["chainId","chainName","token","tokenSymbol","decimals","logoUrl","visible","incognito","usdAmount","pricePerToken","priceStale","spam"]}},"totalUsdAmount":{"example":1.5,"description":"Sum of usdAmount across all balance items. Null when no pricing data is available for any token.","anyOf":[{"type":"number"},{"type":"null"}]},"feeWaiver":{"type":"object","properties":{"active":{"description":"True when Cloaked service fees are currently waived for this account.","type":"boolean"},"source":{"description":"Why fees are waived. activation is the time-limited new-user activation offer; cloakie is the NFT waiver.","anyOf":[{"type":"string","enum":["activation"]},{"type":"string","enum":["cloakie"]},{"type":"null"}]},"activeUntil":{"description":"Expiry timestamp for time-limited waivers. Null for non-expiring waivers.","anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["active","source","activeUntil"]}},"required":["balances","totalUsdAmount","feeWaiver"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}},{"status":"403","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Forbidden","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"404","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Not found","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"429","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Too Many Requests","type":"string"},"message":{"example":"Rate limit exceeded. Maximum 60 requests per 1 minute.","type":"string"}},"required":["error","message"]}},{"status":"503","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Service Unavailable","type":"string"},"message":{"type":"string"},"code":{"example":"SERVER_BUSY","description":"Machine-readable reason, such as SERVER_BUSY or POOL_STATE_REFRESHING.","type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### Get token balance

<EndpointCard data={{"method":"GET","path":"/v1/accounts/{accountId}/balance/{chainId}/{token}","operationId":"getTokenBalance","tags":["Balance & Activity"],"description":"Retrieve the balance for a single token on a specific chain. Returns visible available and pending amounts. Returns a zero-balance object if the token has never been received.","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"},{"schema":{"type":"string"},"in":"path","name":"chainId","required":true,"description":"Chain ID"},{"schema":{"type":"string"},"in":"path","name":"token","required":true,"description":"Token address (0x...)"}],"responses":[{"status":"200","description":"Balance for a single token on a single chain. Contains visible available and pending amounts for standard on-chain stealth address holdings.","schema":{"description":"Balance for a single token on a single chain. Contains visible available and pending amounts for standard on-chain stealth address holdings.","type":"object","properties":{"chainId":{"example":8453,"description":"Chain ID where this token resides","type":"number"},"chainName":{"example":"Base","description":"Human-readable chain name","type":"string"},"token":{"example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Token contract address (EIP-55 checksummed)","type":"string"},"tokenSymbol":{"example":"USDC","description":"Token ticker symbol","type":"string"},"decimals":{"example":6,"description":"Token decimal places","type":"number"},"logoUrl":{"example":"https://assets.coingecko.com/coins/images/6319/small/usdc.png","description":"Token logo URL, or null if unavailable","anyOf":[{"type":"string"},{"type":"null"}]},"visible":{"description":"Standard on-chain balances held in stealth addresses. These funds have no privacy pool provenance — they arrived via receives, swaps, or on-ramps.","type":"object","properties":{"available":{"example":"1000000","description":"Balance available to spend immediately — not locked by any pending transaction (stringified bigint, smallest unit)","type":"string"},"pending":{"example":"500000","description":"Balance locked by an outbound transaction that has not yet confirmed on-chain (stringified bigint, smallest unit)","type":"string"}},"required":["available","pending"]},"incognito":{"description":"Incognito balances from privacy pools. The server tracks available, pending withdrawal, pending approval, and declined tiers.","type":"object","properties":{"pooled":{"description":"Privacy pool balances. Available is the authoritative withdrawable amount tracked by the server.","type":"object","properties":{"available":{"example":"750000","description":"Sum of ASP-approved, unspent, unlocked commitment values — how much the user can withdraw right now. (stringified bigint, smallest unit)","type":"string"},"pendingApproval":{"example":"250000","description":"Deposits awaiting ASP compliance approval. Will become available automatically once approved. Includes inflight deposits confirmed on-chain but not yet indexed. (stringified bigint, smallest unit)","type":"string"},"pendingWithdrawal":{"example":"500000","description":"ASP-approved pool funds locked by a pending withdrawal. Not available for a new send, but still counted in total balance while the withdrawal confirms. (stringified bigint, smallest unit)","type":"string"},"declined":{"example":"0","description":"Deposits that were not allowed to join the pool by the compliance check. Recoverable back to the visible wallet balance via the recovery flow. Distinct from pendingApproval so clients can prompt the recovery action instead of leaving the user waiting on a state that will never resolve on its own. (stringified bigint, smallest unit)","type":"string"}},"required":["available","pendingApproval","pendingWithdrawal","declined"]}},"required":["pooled"]},"usdAmount":{"example":1.5,"description":"Total USD value of visible balance. Null when pricing data is unavailable for a token that has a non-zero balance.","anyOf":[{"type":"number"},{"type":"null"}]},"pricePerToken":{"example":2000.42,"description":"USD price for one whole token (e.g. 1 ETH). Null when pricing data is unavailable. Use this to compute USD values on the client: amount * pricePerToken.","anyOf":[{"type":"number"},{"type":"null"}]},"priceStale":{"example":false,"description":"True when all live price sources failed and the price was served from an expired cache entry","type":"boolean"},"spam":{"example":false,"description":"True if the token is flagged as potential spam or a phishing token","type":"boolean"}},"required":["chainId","chainName","token","tokenSymbol","decimals","logoUrl","visible","incognito","usdAmount","pricePerToken","priceStale","spam"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}},{"status":"403","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Forbidden","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"404","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Not found","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"429","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Too Many Requests","type":"string"},"message":{"example":"Rate limit exceeded. Maximum 60 requests per 1 minute.","type":"string"}},"required":["error","message"]}},{"status":"503","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Service Unavailable","type":"string"},"message":{"type":"string"},"code":{"example":"SERVER_BUSY","description":"Machine-readable reason, such as SERVER_BUSY or POOL_STATE_REFRESHING.","type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### Get activities

<EndpointCard data={{"method":"GET","path":"/v1/accounts/{accountId}/activities","operationId":"getActivities","tags":["Balance & Activity"],"description":"List confirmed (on-chain) transactions for the account with cursor-based pagination. The response uses a discriminated union on kind: SEND/RECEIVE/SELF/INCOGNITO_*/NFT_WITHDRAW/DAPP_CALL include a transfers array, SWAP includes a swap object with source and dest token info, BRIDGE and CROSS_CHAIN_SWAP include a bridge object with source, dest, and chain info. For in-flight transactions, use GET /activities/pending.","parameters":[{"schema":{"type":"string"},"in":"query","name":"limit","required":false,"description":"Maximum number of activities to return (1-500, default: 100)"},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Base64-encoded cursor for pagination"},{"schema":{"anyOf":[{"type":"boolean"},{"enum":["true","false"],"type":"string"}]},"in":"query","name":"hideLikelySpam","required":false,"description":"When true, likely spam activities are filtered before applying the page limit."},{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"provenanceLabelGroups":{"type":"object","additionalProperties":{"type":"object","properties":{"encryptedTagSources":{"description":"Only receive sources with encrypted user tag payloads needed for client-side label display.","type":"array","items":{"type":"object","properties":{"id":{"description":"Stable provenance source key","type":"string"},"kind":{"type":"string","enum":["receive"]},"origin":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"}},"required":["chainId","txHash","transferOrLogIndex"]},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","description":"Owned address where this receive source originally landed","type":"string"},"tagPayloadCiphertext":{"anyOf":[{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","description":"Optional client-encrypted provenance tag payload ciphertext","type":"string"},{"type":"null"}]},"tagPayloadUpdatedAt":{"anyOf":[{"format":"date-time","description":"ISO timestamp for the last provenance tag payload update","type":"string"},{"type":"null"}]},"tagEligibility":{"anyOf":[{"type":"string","enum":["eligible"]},{"type":"string","enum":["received_before_tagging"]}]},"tagEditable":{"description":"True when this receive source is post-launch and may be tagged by the current account","type":"boolean"},"systemTags":{"description":"Server-derived tags based on public onchain facts","type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["pool-receive"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["pool_receive"]},"evidence":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"},"receiveFromAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"entrypointAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolTransferOrLogIndex":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]}},"required":["chainId","txHash","transferOrLogIndex","receiveFromAddress","poolAddress","entrypointAddress","poolTransferOrLogIndex"]}},"required":["type","text","explanationKey","evidence"]},{"type":"object","properties":{"type":{"type":"string","enum":["dapp-used"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["dapp_used"]},"evidence":{"type":"object","properties":{"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"origins":{"type":"array","items":{"type":"object","properties":{"origin":{"type":"string"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastUsedAt":{"format":"date-time","type":"string"}},"required":["origin","displayName","iconUrl","lastUsedAt"]}},"matchedOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestUsedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["address","origins","matchedOrigin","latestUsedAt"]}},"required":["type","text","explanationKey","evidence"]}]}}},"required":["id","kind","origin","address","tagPayloadCiphertext","tagPayloadUpdatedAt","tagEligibility","tagEditable","systemTags"]}},"systemLabels":{"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","enum":["pool_receive"]},{"type":"string","enum":["dapp_used"]}]},"text":{"description":"Short server-derived label text for display","type":"string"},"iconUrl":{"anyOf":[{"description":"Optional safe proxied icon URL for system labels with app metadata","type":"string"},{"type":"null"}]}},"required":["key","text"]}},"hasNoTag":{"description":"True when represented provenance includes at least one untagged source.","type":"boolean"},"hasOlderFunds":{"description":"True when represented provenance includes older/pre-tagging funds.","type":"boolean"},"hasUnknown":{"description":"True when represented provenance includes unresolved provenance.","type":"boolean"}},"required":["encryptedTagSources","systemLabels","hasNoTag","hasOlderFunds","hasUnknown"]}},"activity":{"type":"array","items":{"type":"object","properties":{"txHash":{"anyOf":[{"example":"0x...","type":"string"},{"type":"null"}]},"quoteId":{"format":"uuid","description":"Quote ID that produced this transaction, for correlating pending → confirmed","type":"string"},"chainId":{"example":8453,"type":"number"},"chainName":{"example":"Base","type":"string"},"explorerTxUrlBase":{"description":"Explorer tx URL prefix for the activity's chain; append a tx hash to build a link.","anyOf":[{"example":"https://basescan.org/tx/","type":"string"},{"type":"null"}]},"date":{"format":"date-time","type":"string"},"kind":{"anyOf":[{"type":"string","enum":["SEND"]},{"type":"string","enum":["RECEIVE"]},{"type":"string","enum":["SELF"]},{"type":"string","enum":["SWAP"]},{"type":"string","enum":["BRIDGE"]},{"type":"string","enum":["CROSS_CHAIN_SWAP"]},{"type":"string","enum":["POOL_DEPOSIT"]},{"type":"string","enum":["POOL_RECOVER"]},{"type":"string","enum":["INCOGNITO_SEND"]},{"type":"string","enum":["INCOGNITO_SELF_SEND"]},{"type":"string","enum":["NFT_WITHDRAW"]},{"type":"string","enum":["DAPP_CALL"]},{"type":"string","enum":["OFF_RAMP"]},{"type":"string","enum":["OFF_RAMP_CANCEL"]}]},"lifecycle":{"anyOf":[{"type":"object","properties":{"state":{"type":"string","enum":["indexed"]}},"required":["state"]},{"type":"object","properties":{"state":{"type":"string","enum":["in_flight"]},"relayStatus":{"anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["pending"]},{"type":"string","enum":["stuck"]},{"type":"string","enum":["confirmed"]}]}},"required":["state","relayStatus"]},{"type":"object","properties":{"state":{"type":"string","enum":["failed"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"failureStage":{"anyOf":[{"type":"string","enum":["pre_broadcast"]},{"type":"string","enum":["on_chain"]},{"type":"string","enum":["unknown"]}]}},"required":["state","reason"]}]},"isExternal":{"description":"True for indexed no-intent transactions signed directly by one of the account's addresses.","example":false,"type":"boolean"},"isLikelySpam":{"example":false,"type":"boolean"},"fees":{"type":"array","items":{"type":"object","properties":{"tokenAddress":{"example":"0x...","type":"string"},"decimals":{"example":18,"type":"number"},"tokenSymbol":{"example":"ETH","type":"string"},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"value":{"example":"1000000000000000","type":"string"},"usdAmount":{"description":"USD value of the fee, or null when token USD pricing is unavailable.","anyOf":[{"example":0.001,"type":"number"},{"type":"null"}]}},"required":["tokenAddress","decimals","tokenSymbol","logoUrl","value","usdAmount"]}},"cloakedFeeBps":{"anyOf":[{"description":"Cloaked service fee BPS recorded at quote time. 0 when waived.","type":"number"},{"type":"null"}]},"sourceProvenance":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["resolved"]},{"type":"string","enum":["unavailable"]}]},"sourceLabelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"description":"Number of pre-launch checkpoint provenance markers represented by this balance.","type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}},"displayContext":{"type":"object","properties":{"reason":{"anyOf":[{"type":"string","enum":["fresh_receive"]},{"type":"string","enum":["cloaked_action_output"]},{"type":"string","enum":["mixed_current_outputs"]},{"type":"string","enum":["carried_source"]},{"type":"string","enum":["older_funds"]},{"type":"string","enum":["unavailable"]}]},"currentOutputCount":{"minimum":0,"type":"integer"},"sourceCount":{"minimum":0,"type":"integer"},"actionTypes":{"type":"array","items":{"type":"string"}}},"required":["reason","currentOutputCount","sourceCount","actionTypes"]},"funding":{"type":"object","properties":{"labelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}}},"required":["labelGroupId","olderFundsCount","unresolvedReasons"]},"association":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["clean"]},{"type":"string","enum":["linked"]},{"type":"string","enum":["unknown"]}]},"labelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}},"ignoredUnsolicitedCount":{"minimum":0,"type":"integer"},"summary":{"type":"object","properties":{"sourceCount":{"minimum":0,"type":"integer"},"poolReceiveCount":{"minimum":0,"type":"integer"},"userTaggedSourceCount":{"minimum":0,"type":"integer"},"untaggedSourceCount":{"minimum":0,"type":"integer"},"olderFundsCount":{"minimum":0,"type":"integer"},"unknownCount":{"minimum":0,"type":"integer"}},"required":["sourceCount","poolReceiveCount","userTaggedSourceCount","untaggedSourceCount","olderFundsCount","unknownCount"]}},"required":["status","labelGroupId","olderFundsCount","unresolvedReasons","ignoredUnsolicitedCount","summary"]},"display":{"type":"object","properties":{"badgeKind":{"anyOf":[{"type":"string","enum":["incognito_clean"]},{"type":"string","enum":["tagged"]},{"type":"string","enum":["mixed"]},{"type":"string","enum":["older_funds"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["untagged"]}]},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"fundingLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"associationLabel":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["badgeKind","label","fundingLabel","associationLabel"]},"editableSource":{"description":"The single directly editable receive source for this item, when one exists.","anyOf":[{"type":"object","properties":{"id":{"description":"Stable provenance source key","type":"string"},"kind":{"type":"string","enum":["receive"]},"origin":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"}},"required":["chainId","txHash","transferOrLogIndex"]},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","description":"Owned address where this receive source originally landed","type":"string"},"tagPayloadCiphertext":{"anyOf":[{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","description":"Optional client-encrypted provenance tag payload ciphertext","type":"string"},{"type":"null"}]},"tagPayloadUpdatedAt":{"anyOf":[{"format":"date-time","description":"ISO timestamp for the last provenance tag payload update","type":"string"},{"type":"null"}]},"tagEligibility":{"anyOf":[{"type":"string","enum":["eligible"]},{"type":"string","enum":["received_before_tagging"]}]},"tagEditable":{"description":"True when this receive source is post-launch and may be tagged by the current account","type":"boolean"},"systemTags":{"description":"Server-derived tags based on public onchain facts","type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["pool-receive"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["pool_receive"]},"evidence":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"},"receiveFromAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"entrypointAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolTransferOrLogIndex":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]}},"required":["chainId","txHash","transferOrLogIndex","receiveFromAddress","poolAddress","entrypointAddress","poolTransferOrLogIndex"]}},"required":["type","text","explanationKey","evidence"]},{"type":"object","properties":{"type":{"type":"string","enum":["dapp-used"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["dapp_used"]},"evidence":{"type":"object","properties":{"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"origins":{"type":"array","items":{"type":"object","properties":{"origin":{"type":"string"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastUsedAt":{"format":"date-time","type":"string"}},"required":["origin","displayName","iconUrl","lastUsedAt"]}},"matchedOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestUsedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["address","origins","matchedOrigin","latestUsedAt"]}},"required":["type","text","explanationKey","evidence"]}]}}},"required":["id","kind","origin","address","tagPayloadCiphertext","tagPayloadUpdatedAt","tagEligibility","tagEditable","systemTags"]},{"type":"null"}]}},"required":["status","sourceLabelGroupId","olderFundsCount","unresolvedReasons","displayContext","funding","association","display","editableSource"]},"transfers":{"type":"array","items":{"type":"object","properties":{"tokenAddress":{"example":"0x...","type":"string"},"decimals":{"example":6,"type":"number"},"tokenSymbol":{"example":"USDC","type":"string"},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"fromAddress":{"example":"0x...","type":"string"},"toAddress":{"example":"0x...","type":"string"},"value":{"example":"1000000","type":"string"},"usdAmount":{"description":"USD value of the transfer, or null when token USD pricing is unavailable.","anyOf":[{"example":1,"type":"number"},{"type":"null"}]},"provenance":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["resolved"]},{"type":"string","enum":["unavailable"]}]},"sourceLabelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"description":"Number of pre-launch checkpoint provenance markers represented by this balance.","type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}},"displayContext":{"type":"object","properties":{"reason":{"anyOf":[{"type":"string","enum":["fresh_receive"]},{"type":"string","enum":["cloaked_action_output"]},{"type":"string","enum":["mixed_current_outputs"]},{"type":"string","enum":["carried_source"]},{"type":"string","enum":["older_funds"]},{"type":"string","enum":["unavailable"]}]},"currentOutputCount":{"minimum":0,"type":"integer"},"sourceCount":{"minimum":0,"type":"integer"},"actionTypes":{"type":"array","items":{"type":"string"}}},"required":["reason","currentOutputCount","sourceCount","actionTypes"]},"funding":{"type":"object","properties":{"labelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}}},"required":["labelGroupId","olderFundsCount","unresolvedReasons"]},"association":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["clean"]},{"type":"string","enum":["linked"]},{"type":"string","enum":["unknown"]}]},"labelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}},"ignoredUnsolicitedCount":{"minimum":0,"type":"integer"},"summary":{"type":"object","properties":{"sourceCount":{"minimum":0,"type":"integer"},"poolReceiveCount":{"minimum":0,"type":"integer"},"userTaggedSourceCount":{"minimum":0,"type":"integer"},"untaggedSourceCount":{"minimum":0,"type":"integer"},"olderFundsCount":{"minimum":0,"type":"integer"},"unknownCount":{"minimum":0,"type":"integer"}},"required":["sourceCount","poolReceiveCount","userTaggedSourceCount","untaggedSourceCount","olderFundsCount","unknownCount"]}},"required":["status","labelGroupId","olderFundsCount","unresolvedReasons","ignoredUnsolicitedCount","summary"]},"display":{"type":"object","properties":{"badgeKind":{"anyOf":[{"type":"string","enum":["incognito_clean"]},{"type":"string","enum":["tagged"]},{"type":"string","enum":["mixed"]},{"type":"string","enum":["older_funds"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["untagged"]}]},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"fundingLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"associationLabel":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["badgeKind","label","fundingLabel","associationLabel"]},"editableSource":{"description":"The single directly editable receive source for this item, when one exists.","anyOf":[{"type":"object","properties":{"id":{"description":"Stable provenance source key","type":"string"},"kind":{"type":"string","enum":["receive"]},"origin":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"}},"required":["chainId","txHash","transferOrLogIndex"]},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","description":"Owned address where this receive source originally landed","type":"string"},"tagPayloadCiphertext":{"anyOf":[{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","description":"Optional client-encrypted provenance tag payload ciphertext","type":"string"},{"type":"null"}]},"tagPayloadUpdatedAt":{"anyOf":[{"format":"date-time","description":"ISO timestamp for the last provenance tag payload update","type":"string"},{"type":"null"}]},"tagEligibility":{"anyOf":[{"type":"string","enum":["eligible"]},{"type":"string","enum":["received_before_tagging"]}]},"tagEditable":{"description":"True when this receive source is post-launch and may be tagged by the current account","type":"boolean"},"systemTags":{"description":"Server-derived tags based on public onchain facts","type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["pool-receive"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["pool_receive"]},"evidence":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"},"receiveFromAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"entrypointAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolTransferOrLogIndex":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]}},"required":["chainId","txHash","transferOrLogIndex","receiveFromAddress","poolAddress","entrypointAddress","poolTransferOrLogIndex"]}},"required":["type","text","explanationKey","evidence"]},{"type":"object","properties":{"type":{"type":"string","enum":["dapp-used"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["dapp_used"]},"evidence":{"type":"object","properties":{"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"origins":{"type":"array","items":{"type":"object","properties":{"origin":{"type":"string"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastUsedAt":{"format":"date-time","type":"string"}},"required":["origin","displayName","iconUrl","lastUsedAt"]}},"matchedOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestUsedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["address","origins","matchedOrigin","latestUsedAt"]}},"required":["type","text","explanationKey","evidence"]}]}}},"required":["id","kind","origin","address","tagPayloadCiphertext","tagPayloadUpdatedAt","tagEligibility","tagEditable","systemTags"]},{"type":"null"}]}},"required":["status","sourceLabelGroupId","olderFundsCount","unresolvedReasons","displayContext","funding","association","display","editableSource"]}},"required":["tokenAddress","decimals","tokenSymbol","logoUrl","fromAddress","toAddress","value","usdAmount"]}},"swap":{"type":"object","properties":{"sourceTokenAddress":{"example":"0x...","type":"string"},"sourceDecimals":{"example":6,"type":"number"},"sourceTokenSymbol":{"example":"USDC","type":"string"},"sourceLogoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceAmount":{"example":"1000000","type":"string"},"sourceUsdAmount":{"description":"USD value of the source amount, or null when token USD pricing is unavailable.","anyOf":[{"example":1,"type":"number"},{"type":"null"}]},"destTokenAddress":{"example":"0x...","type":"string"},"destTokenSymbol":{"example":"WETH","type":"string"},"destDecimals":{"example":18,"type":"number"},"destLogoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"destAmount":{"example":"500000000000000","type":"string"},"destUsdAmount":{"description":"USD value of the destination amount, or null when token USD pricing is unavailable.","anyOf":[{"example":0.5,"type":"number"},{"type":"null"}]},"outputRecipient":{"example":"0x...","type":"string"}},"required":["sourceTokenAddress","sourceDecimals","sourceTokenSymbol","sourceLogoUrl","sourceAmount","sourceUsdAmount","destTokenAddress","destTokenSymbol","destDecimals","destLogoUrl","destAmount","destUsdAmount","outputRecipient"]},"bridge":{"type":"object","properties":{"sourceTokenAddress":{"example":"0x...","type":"string"},"sourceDecimals":{"example":6,"type":"number"},"sourceTokenSymbol":{"example":"USDC","type":"string"},"sourceLogoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceAmount":{"example":"1000000","type":"string"},"sourceUsdAmount":{"description":"USD value of the source amount, or null when token USD pricing is unavailable.","anyOf":[{"example":1,"type":"number"},{"type":"null"}]},"destTokenAddress":{"example":"0x...","type":"string"},"destTokenSymbol":{"example":"USDC","type":"string"},"destDecimals":{"example":6,"type":"number"},"destLogoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"destAmount":{"example":"1000000","type":"string"},"destUsdAmount":{"description":"USD value of the destination amount, or null when token USD pricing is unavailable.","anyOf":[{"example":1,"type":"number"},{"type":"null"}]},"outputRecipient":{"example":"0x...","type":"string"},"bridgeStatus":{"example":"pending","type":"string"},"destChainId":{"example":8453,"type":"number"},"destChainName":{"example":"Base","type":"string"},"destExplorerTxUrlBase":{"description":"Explorer tx URL prefix for the destination chain; append destTxHash.","anyOf":[{"type":"string"},{"type":"null"}]},"estimatedFillTimeMs":{"anyOf":[{"type":"number"},{"type":"null"}]},"destTxHash":{"anyOf":[{"example":"0x...","type":"string"},{"type":"null"}]},"refundTxHash":{"anyOf":[{"example":"0x...","type":"string"},{"type":"null"}]},"refundEligibleAt":{"anyOf":[{"format":"date-time","description":"ISO timestamp when an unfilled Across bridge becomes refund-eligible","type":"string"},{"type":"null"}]}},"required":["sourceTokenAddress","sourceDecimals","sourceTokenSymbol","sourceLogoUrl","sourceAmount","sourceUsdAmount","destTokenAddress","destTokenSymbol","destDecimals","destLogoUrl","destAmount","destUsdAmount","outputRecipient","bridgeStatus","destChainId","destChainName","destExplorerTxUrlBase","estimatedFillTimeMs","destTxHash","refundTxHash","refundEligibleAt"]},"pool":{"type":"object","properties":{"poolAddress":{"example":"0x...","type":"string"},"tokenAddress":{"example":"0x...","type":"string"},"decimals":{"example":18,"type":"number"},"tokenSymbol":{"example":"ETH","type":"string"},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"amount":{"example":"1000000000000000","type":"string"},"usdAmount":{"description":"USD value of the pool amount, or null when token USD pricing is unavailable.","anyOf":[{"example":1,"type":"number"},{"type":"null"}]},"aspStatus":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["approved"]},{"type":"string","enum":["declined"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["cancelled"]}]},"commitmentId":{"type":"string"},"vettingFee":{"type":"string"},"vettingFeeUsd":{"anyOf":[{"type":"number"},{"type":"null"}]},"depositFee":{"type":"string"},"depositFeeUsd":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["poolAddress","tokenAddress","decimals","tokenSymbol","logoUrl","amount","usdAmount"]},"dappMeta":{"type":"object","properties":{"origin":{"type":"string"},"description":{"type":"string"},"connectedAddress":{"type":"string"}}},"calldata":{"description":"Raw calls JSON for dapp-call activities: [{ to, value, data }]","type":"string"},"offRamp":{"type":"object","properties":{"peerDepositId":{"description":"DB row UUID of the peer_deposit","type":"string"},"paymentMethod":{"example":"venmo","type":"string"},"phase":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["awaiting_fill"]},{"type":"string","enum":["filling"]},{"type":"string","enum":["partial_idle"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["cancel_pending"]},{"type":"string","enum":["cancel_settling"]},{"type":"string","enum":["recoverable"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["abandoned"]},{"type":"string","enum":["refunded"]},{"type":"string","enum":["failed"]}]},"failureKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"depositId":{"anyOf":[{"type":"string"},{"type":"null"}]},"peerUrl":{"anyOf":[{"description":"Peer deposit page URL, null until depositId is known","type":"string"},{"type":"null"}]},"sourceChainId":{"type":"number"},"sourceTokenAddress":{"type":"string"},"sourceDecimals":{"type":"number"},"sourceTokenSymbol":{"type":"string"},"sourceLogoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceAmount":{"description":"Stringified bigint","type":"string"},"escrowChainId":{"type":"number"},"escrowTokenAddress":{"type":"string"},"escrowDecimals":{"type":"number"},"escrowTokenSymbol":{"type":"string"},"escrowLogoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"escrowAmount":{"description":"Stringified bigint","type":"string"},"usdAmount":{"anyOf":[{"type":"number"},{"type":"null"}]},"estimatedFiatAmount":{"anyOf":[{"type":"number"},{"type":"null"}]},"tokenAddress":{"type":"string"},"decimals":{"type":"number"},"tokenSymbol":{"type":"string"},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"filled":{"anyOf":[{"type":"string"},{"type":"null"}]},"remaining":{"anyOf":[{"description":"Stringified bigint — on-chain remainingDeposits","type":"string"},{"type":"null"}]},"outstanding":{"anyOf":[{"description":"Stringified bigint — on-chain outstandingIntentAmount","type":"string"},{"type":"null"}]},"progress":{"type":"object","properties":{"filled":{"anyOf":[{"description":"Stringified bigint — amount paid out through fiat method","type":"string"},{"type":"null"}]},"inProgress":{"anyOf":[{"description":"Stringified bigint — amount matched but not settled","type":"string"},{"type":"null"}]},"waiting":{"anyOf":[{"description":"Stringified bigint — amount still waiting for a sender","type":"string"},{"type":"null"}]},"withdrawn":{"anyOf":[{"description":"Stringified bigint — amount withdrawn or being withdrawn","type":"string"},{"type":"null"}]},"recoverable":{"anyOf":[{"description":"Stringified bigint — amount available to recover","type":"string"},{"type":"null"}]},"cancelWithdrawTxHash":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["filled","inProgress","waiting","withdrawn","recoverable","cancelWithdrawTxHash"]},"recoverableAt":{"anyOf":[{"description":"ISO timestamp; max expiry across outstanding intents","type":"string"},{"type":"null"}]},"buyerPaymentDueAt":{"anyOf":[{"description":"ISO timestamp; buyer payment window deadline for currently outstanding intents","type":"string"},{"type":"null"}]},"fromIncognito":{"description":"Whether the source funds came from an incognito pool","type":"boolean"},"route":{"type":"object","properties":{"steps":{"type":"array","items":{"type":"object","properties":{"id":{"description":"Provider identifier, e.g. uniswap/across/peer","type":"string"},"label":{"description":"Human-readable provider name","type":"string"}},"required":["id","label"]}},"description":{"description":"Human-readable explanation of the route","type":"string"}},"required":["steps","description"]},"serviceFee":{"description":"Stringified bigint — service fee","type":"string"},"serviceFeeTokenAddress":{"type":"string"},"serviceFeeChainId":{"type":"number"},"serviceFeeDecimals":{"type":"number"},"serviceFeeTokenSymbol":{"type":"string"},"serviceFeeLogoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"serviceFeeUsd":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["peerDepositId","paymentMethod","phase","failureKind","depositId","peerUrl","sourceChainId","sourceTokenAddress","sourceDecimals","sourceTokenSymbol","sourceLogoUrl","sourceAmount","escrowChainId","escrowTokenAddress","escrowDecimals","escrowTokenSymbol","escrowLogoUrl","escrowAmount","usdAmount","estimatedFiatAmount","tokenAddress","decimals","tokenSymbol","logoUrl","filled","remaining","outstanding","progress","recoverableAt","buyerPaymentDueAt"]}},"required":["txHash","chainId","chainName","explorerTxUrlBase","date","kind","lifecycle","isExternal","isLikelySpam","fees"]}},"pagination":{"type":"object","properties":{"limit":{"example":100,"type":"number"},"nextCursor":{"description":"Base64-encoded cursor for next page","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["limit","nextCursor"]}},"required":["provenanceLabelGroups","activity","pagination"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}},{"status":"404","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Not found","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"503","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Service Unavailable","type":"string"},"message":{"type":"string"},"code":{"example":"SERVER_BUSY","description":"Machine-readable reason, such as SERVER_BUSY or POOL_STATE_REFRESHING.","type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### Get pending activities

<EndpointCard data={{"method":"GET","path":"/v1/accounts/{accountId}/activities/pending","operationId":"getPendingActivities","tags":["Balance & Activity"],"description":"List in-flight relay transactions (queued, pending, stuck) and recently confirmed/failed transactions for the account. The response uses the same shape as GET /activities: same kind values, same payload sub-objects. The lifecycle.state discriminates between 'in_flight', 'indexed', and 'failed'. Recently confirmed transactions are included for up to 5 minutes so the client can show continuous state while the transaction is indexed.","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"provenanceLabelGroups":{"type":"object","additionalProperties":{"type":"object","properties":{"encryptedTagSources":{"description":"Only receive sources with encrypted user tag payloads needed for client-side label display.","type":"array","items":{"type":"object","properties":{"id":{"description":"Stable provenance source key","type":"string"},"kind":{"type":"string","enum":["receive"]},"origin":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"}},"required":["chainId","txHash","transferOrLogIndex"]},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","description":"Owned address where this receive source originally landed","type":"string"},"tagPayloadCiphertext":{"anyOf":[{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","description":"Optional client-encrypted provenance tag payload ciphertext","type":"string"},{"type":"null"}]},"tagPayloadUpdatedAt":{"anyOf":[{"format":"date-time","description":"ISO timestamp for the last provenance tag payload update","type":"string"},{"type":"null"}]},"tagEligibility":{"anyOf":[{"type":"string","enum":["eligible"]},{"type":"string","enum":["received_before_tagging"]}]},"tagEditable":{"description":"True when this receive source is post-launch and may be tagged by the current account","type":"boolean"},"systemTags":{"description":"Server-derived tags based on public onchain facts","type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["pool-receive"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["pool_receive"]},"evidence":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"},"receiveFromAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"entrypointAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolTransferOrLogIndex":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]}},"required":["chainId","txHash","transferOrLogIndex","receiveFromAddress","poolAddress","entrypointAddress","poolTransferOrLogIndex"]}},"required":["type","text","explanationKey","evidence"]},{"type":"object","properties":{"type":{"type":"string","enum":["dapp-used"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["dapp_used"]},"evidence":{"type":"object","properties":{"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"origins":{"type":"array","items":{"type":"object","properties":{"origin":{"type":"string"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastUsedAt":{"format":"date-time","type":"string"}},"required":["origin","displayName","iconUrl","lastUsedAt"]}},"matchedOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestUsedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["address","origins","matchedOrigin","latestUsedAt"]}},"required":["type","text","explanationKey","evidence"]}]}}},"required":["id","kind","origin","address","tagPayloadCiphertext","tagPayloadUpdatedAt","tagEligibility","tagEditable","systemTags"]}},"systemLabels":{"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","enum":["pool_receive"]},{"type":"string","enum":["dapp_used"]}]},"text":{"description":"Short server-derived label text for display","type":"string"},"iconUrl":{"anyOf":[{"description":"Optional safe proxied icon URL for system labels with app metadata","type":"string"},{"type":"null"}]}},"required":["key","text"]}},"hasNoTag":{"description":"True when represented provenance includes at least one untagged source.","type":"boolean"},"hasOlderFunds":{"description":"True when represented provenance includes older/pre-tagging funds.","type":"boolean"},"hasUnknown":{"description":"True when represented provenance includes unresolved provenance.","type":"boolean"}},"required":["encryptedTagSources","systemLabels","hasNoTag","hasOlderFunds","hasUnknown"]}},"pending":{"type":"array","items":{"type":"object","properties":{"txHash":{"anyOf":[{"example":"0x...","type":"string"},{"type":"null"}]},"quoteId":{"format":"uuid","description":"Quote ID that produced this transaction, for correlating pending → confirmed","type":"string"},"chainId":{"example":8453,"type":"number"},"chainName":{"example":"Base","type":"string"},"explorerTxUrlBase":{"description":"Explorer tx URL prefix for the activity's chain; append a tx hash to build a link.","anyOf":[{"example":"https://basescan.org/tx/","type":"string"},{"type":"null"}]},"date":{"format":"date-time","type":"string"},"kind":{"anyOf":[{"type":"string","enum":["SEND"]},{"type":"string","enum":["RECEIVE"]},{"type":"string","enum":["SELF"]},{"type":"string","enum":["SWAP"]},{"type":"string","enum":["BRIDGE"]},{"type":"string","enum":["CROSS_CHAIN_SWAP"]},{"type":"string","enum":["POOL_DEPOSIT"]},{"type":"string","enum":["POOL_RECOVER"]},{"type":"string","enum":["INCOGNITO_SEND"]},{"type":"string","enum":["INCOGNITO_SELF_SEND"]},{"type":"string","enum":["NFT_WITHDRAW"]},{"type":"string","enum":["DAPP_CALL"]},{"type":"string","enum":["OFF_RAMP"]},{"type":"string","enum":["OFF_RAMP_CANCEL"]}]},"lifecycle":{"anyOf":[{"type":"object","properties":{"state":{"type":"string","enum":["indexed"]}},"required":["state"]},{"type":"object","properties":{"state":{"type":"string","enum":["in_flight"]},"relayStatus":{"anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["pending"]},{"type":"string","enum":["stuck"]},{"type":"string","enum":["confirmed"]}]}},"required":["state","relayStatus"]},{"type":"object","properties":{"state":{"type":"string","enum":["failed"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"failureStage":{"anyOf":[{"type":"string","enum":["pre_broadcast"]},{"type":"string","enum":["on_chain"]},{"type":"string","enum":["unknown"]}]}},"required":["state","reason"]}]},"isExternal":{"description":"True for indexed no-intent transactions signed directly by one of the account's addresses.","example":false,"type":"boolean"},"isLikelySpam":{"example":false,"type":"boolean"},"fees":{"type":"array","items":{"type":"object","properties":{"tokenAddress":{"example":"0x...","type":"string"},"decimals":{"example":18,"type":"number"},"tokenSymbol":{"example":"ETH","type":"string"},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"value":{"example":"1000000000000000","type":"string"},"usdAmount":{"description":"USD value of the fee, or null when token USD pricing is unavailable.","anyOf":[{"example":0.001,"type":"number"},{"type":"null"}]}},"required":["tokenAddress","decimals","tokenSymbol","logoUrl","value","usdAmount"]}},"cloakedFeeBps":{"anyOf":[{"description":"Cloaked service fee BPS recorded at quote time. 0 when waived.","type":"number"},{"type":"null"}]},"sourceProvenance":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["resolved"]},{"type":"string","enum":["unavailable"]}]},"sourceLabelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"description":"Number of pre-launch checkpoint provenance markers represented by this balance.","type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}},"displayContext":{"type":"object","properties":{"reason":{"anyOf":[{"type":"string","enum":["fresh_receive"]},{"type":"string","enum":["cloaked_action_output"]},{"type":"string","enum":["mixed_current_outputs"]},{"type":"string","enum":["carried_source"]},{"type":"string","enum":["older_funds"]},{"type":"string","enum":["unavailable"]}]},"currentOutputCount":{"minimum":0,"type":"integer"},"sourceCount":{"minimum":0,"type":"integer"},"actionTypes":{"type":"array","items":{"type":"string"}}},"required":["reason","currentOutputCount","sourceCount","actionTypes"]},"funding":{"type":"object","properties":{"labelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}}},"required":["labelGroupId","olderFundsCount","unresolvedReasons"]},"association":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["clean"]},{"type":"string","enum":["linked"]},{"type":"string","enum":["unknown"]}]},"labelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}},"ignoredUnsolicitedCount":{"minimum":0,"type":"integer"},"summary":{"type":"object","properties":{"sourceCount":{"minimum":0,"type":"integer"},"poolReceiveCount":{"minimum":0,"type":"integer"},"userTaggedSourceCount":{"minimum":0,"type":"integer"},"untaggedSourceCount":{"minimum":0,"type":"integer"},"olderFundsCount":{"minimum":0,"type":"integer"},"unknownCount":{"minimum":0,"type":"integer"}},"required":["sourceCount","poolReceiveCount","userTaggedSourceCount","untaggedSourceCount","olderFundsCount","unknownCount"]}},"required":["status","labelGroupId","olderFundsCount","unresolvedReasons","ignoredUnsolicitedCount","summary"]},"display":{"type":"object","properties":{"badgeKind":{"anyOf":[{"type":"string","enum":["incognito_clean"]},{"type":"string","enum":["tagged"]},{"type":"string","enum":["mixed"]},{"type":"string","enum":["older_funds"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["untagged"]}]},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"fundingLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"associationLabel":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["badgeKind","label","fundingLabel","associationLabel"]},"editableSource":{"description":"The single directly editable receive source for this item, when one exists.","anyOf":[{"type":"object","properties":{"id":{"description":"Stable provenance source key","type":"string"},"kind":{"type":"string","enum":["receive"]},"origin":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"}},"required":["chainId","txHash","transferOrLogIndex"]},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","description":"Owned address where this receive source originally landed","type":"string"},"tagPayloadCiphertext":{"anyOf":[{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","description":"Optional client-encrypted provenance tag payload ciphertext","type":"string"},{"type":"null"}]},"tagPayloadUpdatedAt":{"anyOf":[{"format":"date-time","description":"ISO timestamp for the last provenance tag payload update","type":"string"},{"type":"null"}]},"tagEligibility":{"anyOf":[{"type":"string","enum":["eligible"]},{"type":"string","enum":["received_before_tagging"]}]},"tagEditable":{"description":"True when this receive source is post-launch and may be tagged by the current account","type":"boolean"},"systemTags":{"description":"Server-derived tags based on public onchain facts","type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["pool-receive"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["pool_receive"]},"evidence":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"},"receiveFromAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"entrypointAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolTransferOrLogIndex":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]}},"required":["chainId","txHash","transferOrLogIndex","receiveFromAddress","poolAddress","entrypointAddress","poolTransferOrLogIndex"]}},"required":["type","text","explanationKey","evidence"]},{"type":"object","properties":{"type":{"type":"string","enum":["dapp-used"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["dapp_used"]},"evidence":{"type":"object","properties":{"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"origins":{"type":"array","items":{"type":"object","properties":{"origin":{"type":"string"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastUsedAt":{"format":"date-time","type":"string"}},"required":["origin","displayName","iconUrl","lastUsedAt"]}},"matchedOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestUsedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["address","origins","matchedOrigin","latestUsedAt"]}},"required":["type","text","explanationKey","evidence"]}]}}},"required":["id","kind","origin","address","tagPayloadCiphertext","tagPayloadUpdatedAt","tagEligibility","tagEditable","systemTags"]},{"type":"null"}]}},"required":["status","sourceLabelGroupId","olderFundsCount","unresolvedReasons","displayContext","funding","association","display","editableSource"]},"transfers":{"type":"array","items":{"type":"object","properties":{"tokenAddress":{"example":"0x...","type":"string"},"decimals":{"example":6,"type":"number"},"tokenSymbol":{"example":"USDC","type":"string"},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"fromAddress":{"example":"0x...","type":"string"},"toAddress":{"example":"0x...","type":"string"},"value":{"example":"1000000","type":"string"},"usdAmount":{"description":"USD value of the transfer, or null when token USD pricing is unavailable.","anyOf":[{"example":1,"type":"number"},{"type":"null"}]},"provenance":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["resolved"]},{"type":"string","enum":["unavailable"]}]},"sourceLabelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"description":"Number of pre-launch checkpoint provenance markers represented by this balance.","type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}},"displayContext":{"type":"object","properties":{"reason":{"anyOf":[{"type":"string","enum":["fresh_receive"]},{"type":"string","enum":["cloaked_action_output"]},{"type":"string","enum":["mixed_current_outputs"]},{"type":"string","enum":["carried_source"]},{"type":"string","enum":["older_funds"]},{"type":"string","enum":["unavailable"]}]},"currentOutputCount":{"minimum":0,"type":"integer"},"sourceCount":{"minimum":0,"type":"integer"},"actionTypes":{"type":"array","items":{"type":"string"}}},"required":["reason","currentOutputCount","sourceCount","actionTypes"]},"funding":{"type":"object","properties":{"labelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}}},"required":["labelGroupId","olderFundsCount","unresolvedReasons"]},"association":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["clean"]},{"type":"string","enum":["linked"]},{"type":"string","enum":["unknown"]}]},"labelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}},"ignoredUnsolicitedCount":{"minimum":0,"type":"integer"},"summary":{"type":"object","properties":{"sourceCount":{"minimum":0,"type":"integer"},"poolReceiveCount":{"minimum":0,"type":"integer"},"userTaggedSourceCount":{"minimum":0,"type":"integer"},"untaggedSourceCount":{"minimum":0,"type":"integer"},"olderFundsCount":{"minimum":0,"type":"integer"},"unknownCount":{"minimum":0,"type":"integer"}},"required":["sourceCount","poolReceiveCount","userTaggedSourceCount","untaggedSourceCount","olderFundsCount","unknownCount"]}},"required":["status","labelGroupId","olderFundsCount","unresolvedReasons","ignoredUnsolicitedCount","summary"]},"display":{"type":"object","properties":{"badgeKind":{"anyOf":[{"type":"string","enum":["incognito_clean"]},{"type":"string","enum":["tagged"]},{"type":"string","enum":["mixed"]},{"type":"string","enum":["older_funds"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["untagged"]}]},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"fundingLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"associationLabel":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["badgeKind","label","fundingLabel","associationLabel"]},"editableSource":{"description":"The single directly editable receive source for this item, when one exists.","anyOf":[{"type":"object","properties":{"id":{"description":"Stable provenance source key","type":"string"},"kind":{"type":"string","enum":["receive"]},"origin":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"}},"required":["chainId","txHash","transferOrLogIndex"]},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","description":"Owned address where this receive source originally landed","type":"string"},"tagPayloadCiphertext":{"anyOf":[{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","description":"Optional client-encrypted provenance tag payload ciphertext","type":"string"},{"type":"null"}]},"tagPayloadUpdatedAt":{"anyOf":[{"format":"date-time","description":"ISO timestamp for the last provenance tag payload update","type":"string"},{"type":"null"}]},"tagEligibility":{"anyOf":[{"type":"string","enum":["eligible"]},{"type":"string","enum":["received_before_tagging"]}]},"tagEditable":{"description":"True when this receive source is post-launch and may be tagged by the current account","type":"boolean"},"systemTags":{"description":"Server-derived tags based on public onchain facts","type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["pool-receive"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["pool_receive"]},"evidence":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"},"receiveFromAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"entrypointAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolTransferOrLogIndex":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]}},"required":["chainId","txHash","transferOrLogIndex","receiveFromAddress","poolAddress","entrypointAddress","poolTransferOrLogIndex"]}},"required":["type","text","explanationKey","evidence"]},{"type":"object","properties":{"type":{"type":"string","enum":["dapp-used"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["dapp_used"]},"evidence":{"type":"object","properties":{"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"origins":{"type":"array","items":{"type":"object","properties":{"origin":{"type":"string"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastUsedAt":{"format":"date-time","type":"string"}},"required":["origin","displayName","iconUrl","lastUsedAt"]}},"matchedOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestUsedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["address","origins","matchedOrigin","latestUsedAt"]}},"required":["type","text","explanationKey","evidence"]}]}}},"required":["id","kind","origin","address","tagPayloadCiphertext","tagPayloadUpdatedAt","tagEligibility","tagEditable","systemTags"]},{"type":"null"}]}},"required":["status","sourceLabelGroupId","olderFundsCount","unresolvedReasons","displayContext","funding","association","display","editableSource"]}},"required":["tokenAddress","decimals","tokenSymbol","logoUrl","fromAddress","toAddress","value","usdAmount"]}},"swap":{"type":"object","properties":{"sourceTokenAddress":{"example":"0x...","type":"string"},"sourceDecimals":{"example":6,"type":"number"},"sourceTokenSymbol":{"example":"USDC","type":"string"},"sourceLogoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceAmount":{"example":"1000000","type":"string"},"sourceUsdAmount":{"description":"USD value of the source amount, or null when token USD pricing is unavailable.","anyOf":[{"example":1,"type":"number"},{"type":"null"}]},"destTokenAddress":{"example":"0x...","type":"string"},"destTokenSymbol":{"example":"WETH","type":"string"},"destDecimals":{"example":18,"type":"number"},"destLogoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"destAmount":{"example":"500000000000000","type":"string"},"destUsdAmount":{"description":"USD value of the destination amount, or null when token USD pricing is unavailable.","anyOf":[{"example":0.5,"type":"number"},{"type":"null"}]},"outputRecipient":{"example":"0x...","type":"string"}},"required":["sourceTokenAddress","sourceDecimals","sourceTokenSymbol","sourceLogoUrl","sourceAmount","sourceUsdAmount","destTokenAddress","destTokenSymbol","destDecimals","destLogoUrl","destAmount","destUsdAmount","outputRecipient"]},"bridge":{"type":"object","properties":{"sourceTokenAddress":{"example":"0x...","type":"string"},"sourceDecimals":{"example":6,"type":"number"},"sourceTokenSymbol":{"example":"USDC","type":"string"},"sourceLogoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceAmount":{"example":"1000000","type":"string"},"sourceUsdAmount":{"description":"USD value of the source amount, or null when token USD pricing is unavailable.","anyOf":[{"example":1,"type":"number"},{"type":"null"}]},"destTokenAddress":{"example":"0x...","type":"string"},"destTokenSymbol":{"example":"USDC","type":"string"},"destDecimals":{"example":6,"type":"number"},"destLogoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"destAmount":{"example":"1000000","type":"string"},"destUsdAmount":{"description":"USD value of the destination amount, or null when token USD pricing is unavailable.","anyOf":[{"example":1,"type":"number"},{"type":"null"}]},"outputRecipient":{"example":"0x...","type":"string"},"bridgeStatus":{"example":"pending","type":"string"},"destChainId":{"example":8453,"type":"number"},"destChainName":{"example":"Base","type":"string"},"destExplorerTxUrlBase":{"description":"Explorer tx URL prefix for the destination chain; append destTxHash.","anyOf":[{"type":"string"},{"type":"null"}]},"estimatedFillTimeMs":{"anyOf":[{"type":"number"},{"type":"null"}]},"destTxHash":{"anyOf":[{"example":"0x...","type":"string"},{"type":"null"}]},"refundTxHash":{"anyOf":[{"example":"0x...","type":"string"},{"type":"null"}]},"refundEligibleAt":{"anyOf":[{"format":"date-time","description":"ISO timestamp when an unfilled Across bridge becomes refund-eligible","type":"string"},{"type":"null"}]}},"required":["sourceTokenAddress","sourceDecimals","sourceTokenSymbol","sourceLogoUrl","sourceAmount","sourceUsdAmount","destTokenAddress","destTokenSymbol","destDecimals","destLogoUrl","destAmount","destUsdAmount","outputRecipient","bridgeStatus","destChainId","destChainName","destExplorerTxUrlBase","estimatedFillTimeMs","destTxHash","refundTxHash","refundEligibleAt"]},"pool":{"type":"object","properties":{"poolAddress":{"example":"0x...","type":"string"},"tokenAddress":{"example":"0x...","type":"string"},"decimals":{"example":18,"type":"number"},"tokenSymbol":{"example":"ETH","type":"string"},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"amount":{"example":"1000000000000000","type":"string"},"usdAmount":{"description":"USD value of the pool amount, or null when token USD pricing is unavailable.","anyOf":[{"example":1,"type":"number"},{"type":"null"}]},"aspStatus":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["approved"]},{"type":"string","enum":["declined"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["cancelled"]}]},"commitmentId":{"type":"string"},"vettingFee":{"type":"string"},"vettingFeeUsd":{"anyOf":[{"type":"number"},{"type":"null"}]},"depositFee":{"type":"string"},"depositFeeUsd":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["poolAddress","tokenAddress","decimals","tokenSymbol","logoUrl","amount","usdAmount"]},"dappMeta":{"type":"object","properties":{"origin":{"type":"string"},"description":{"type":"string"},"connectedAddress":{"type":"string"}}},"calldata":{"description":"Raw calls JSON for dapp-call activities: [{ to, value, data }]","type":"string"},"offRamp":{"type":"object","properties":{"peerDepositId":{"description":"DB row UUID of the peer_deposit","type":"string"},"paymentMethod":{"example":"venmo","type":"string"},"phase":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["awaiting_fill"]},{"type":"string","enum":["filling"]},{"type":"string","enum":["partial_idle"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["cancel_pending"]},{"type":"string","enum":["cancel_settling"]},{"type":"string","enum":["recoverable"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["abandoned"]},{"type":"string","enum":["refunded"]},{"type":"string","enum":["failed"]}]},"failureKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"depositId":{"anyOf":[{"type":"string"},{"type":"null"}]},"peerUrl":{"anyOf":[{"description":"Peer deposit page URL, null until depositId is known","type":"string"},{"type":"null"}]},"sourceChainId":{"type":"number"},"sourceTokenAddress":{"type":"string"},"sourceDecimals":{"type":"number"},"sourceTokenSymbol":{"type":"string"},"sourceLogoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceAmount":{"description":"Stringified bigint","type":"string"},"escrowChainId":{"type":"number"},"escrowTokenAddress":{"type":"string"},"escrowDecimals":{"type":"number"},"escrowTokenSymbol":{"type":"string"},"escrowLogoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"escrowAmount":{"description":"Stringified bigint","type":"string"},"usdAmount":{"anyOf":[{"type":"number"},{"type":"null"}]},"estimatedFiatAmount":{"anyOf":[{"type":"number"},{"type":"null"}]},"tokenAddress":{"type":"string"},"decimals":{"type":"number"},"tokenSymbol":{"type":"string"},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"filled":{"anyOf":[{"type":"string"},{"type":"null"}]},"remaining":{"anyOf":[{"description":"Stringified bigint — on-chain remainingDeposits","type":"string"},{"type":"null"}]},"outstanding":{"anyOf":[{"description":"Stringified bigint — on-chain outstandingIntentAmount","type":"string"},{"type":"null"}]},"progress":{"type":"object","properties":{"filled":{"anyOf":[{"description":"Stringified bigint — amount paid out through fiat method","type":"string"},{"type":"null"}]},"inProgress":{"anyOf":[{"description":"Stringified bigint — amount matched but not settled","type":"string"},{"type":"null"}]},"waiting":{"anyOf":[{"description":"Stringified bigint — amount still waiting for a sender","type":"string"},{"type":"null"}]},"withdrawn":{"anyOf":[{"description":"Stringified bigint — amount withdrawn or being withdrawn","type":"string"},{"type":"null"}]},"recoverable":{"anyOf":[{"description":"Stringified bigint — amount available to recover","type":"string"},{"type":"null"}]},"cancelWithdrawTxHash":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["filled","inProgress","waiting","withdrawn","recoverable","cancelWithdrawTxHash"]},"recoverableAt":{"anyOf":[{"description":"ISO timestamp; max expiry across outstanding intents","type":"string"},{"type":"null"}]},"buyerPaymentDueAt":{"anyOf":[{"description":"ISO timestamp; buyer payment window deadline for currently outstanding intents","type":"string"},{"type":"null"}]},"fromIncognito":{"description":"Whether the source funds came from an incognito pool","type":"boolean"},"route":{"type":"object","properties":{"steps":{"type":"array","items":{"type":"object","properties":{"id":{"description":"Provider identifier, e.g. uniswap/across/peer","type":"string"},"label":{"description":"Human-readable provider name","type":"string"}},"required":["id","label"]}},"description":{"description":"Human-readable explanation of the route","type":"string"}},"required":["steps","description"]},"serviceFee":{"description":"Stringified bigint — service fee","type":"string"},"serviceFeeTokenAddress":{"type":"string"},"serviceFeeChainId":{"type":"number"},"serviceFeeDecimals":{"type":"number"},"serviceFeeTokenSymbol":{"type":"string"},"serviceFeeLogoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"serviceFeeUsd":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["peerDepositId","paymentMethod","phase","failureKind","depositId","peerUrl","sourceChainId","sourceTokenAddress","sourceDecimals","sourceTokenSymbol","sourceLogoUrl","sourceAmount","escrowChainId","escrowTokenAddress","escrowDecimals","escrowTokenSymbol","escrowLogoUrl","escrowAmount","usdAmount","estimatedFiatAmount","tokenAddress","decimals","tokenSymbol","logoUrl","filled","remaining","outstanding","progress","recoverableAt","buyerPaymentDueAt"]}},"required":["txHash","chainId","chainName","explorerTxUrlBase","date","kind","lifecycle","isExternal","isLikelySpam","fees"]}}},"required":["provenanceLabelGroups","pending"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}},{"status":"404","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Not found","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"503","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Service Unavailable","type":"string"},"message":{"type":"string"},"code":{"example":"SERVER_BUSY","description":"Machine-readable reason, such as SERVER_BUSY or POOL_STATE_REFRESHING.","type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### Get deposit review

<EndpointCard data={{"method":"GET","path":"/v1/accounts/{accountId}/deposit-review","operationId":"getDepositReview","tags":["Balance & Activity"],"description":"Return one review row per fresh inbound address, including current review state, visible assets, tags, and Incognito deposit progress.","parameters":[{"schema":{"anyOf":[{"type":"string","enum":["needs_review"]},{"type":"string","enum":["in_progress"]},{"type":"string","enum":["done"]}]},"in":"query","name":"tab","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"minimum":1,"maximum":100,"type":"integer"},"in":"query","name":"limit","required":false},{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"reviewStatus":{"anyOf":[{"type":"string","enum":["needs_review"]},{"type":"string","enum":["in_progress"]},{"type":"string","enum":["done"]}]},"statusReason":{"anyOf":[{"type":"string","enum":["untagged"]},{"type":"string","enum":["tags_added"]},{"type":"string","enum":["pool_deposit_in_progress"]},{"type":"string","enum":["pool_deposit_rejected"]},{"type":"string","enum":["pool_deposited"]}]},"provenanceSources":{"type":"array","items":{"type":"object","properties":{"id":{"description":"Stable provenance source key","type":"string"},"kind":{"type":"string","enum":["receive"]},"origin":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"}},"required":["chainId","txHash","transferOrLogIndex"]},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","description":"Owned address where this receive source originally landed","type":"string"},"tagPayloadCiphertext":{"anyOf":[{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","description":"Optional client-encrypted provenance tag payload ciphertext","type":"string"},{"type":"null"}]},"tagPayloadUpdatedAt":{"anyOf":[{"format":"date-time","description":"ISO timestamp for the last provenance tag payload update","type":"string"},{"type":"null"}]},"tagEligibility":{"anyOf":[{"type":"string","enum":["eligible"]},{"type":"string","enum":["received_before_tagging"]}]},"tagEditable":{"description":"True when this receive source is post-launch and may be tagged by the current account","type":"boolean"},"systemTags":{"description":"Server-derived tags based on public onchain facts","type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["pool-receive"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["pool_receive"]},"evidence":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"},"receiveFromAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"entrypointAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolTransferOrLogIndex":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]}},"required":["chainId","txHash","transferOrLogIndex","receiveFromAddress","poolAddress","entrypointAddress","poolTransferOrLogIndex"]}},"required":["type","text","explanationKey","evidence"]},{"type":"object","properties":{"type":{"type":"string","enum":["dapp-used"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["dapp_used"]},"evidence":{"type":"object","properties":{"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"origins":{"type":"array","items":{"type":"object","properties":{"origin":{"type":"string"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastUsedAt":{"format":"date-time","type":"string"}},"required":["origin","displayName","iconUrl","lastUsedAt"]}},"matchedOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestUsedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["address","origins","matchedOrigin","latestUsedAt"]}},"required":["type","text","explanationKey","evidence"]}]}}},"required":["id","kind","origin","address","tagPayloadCiphertext","tagPayloadUpdatedAt","tagEligibility","tagEditable","systemTags"]}},"assets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"reviewStatus":{"anyOf":[{"type":"string","enum":["needs_review"]},{"type":"string","enum":["in_progress"]},{"type":"string","enum":["done"]}]},"statusReason":{"anyOf":[{"type":"string","enum":["untagged"]},{"type":"string","enum":["tags_added"]},{"type":"string","enum":["pool_deposit_in_progress"]},{"type":"string","enum":["pool_deposit_rejected"]},{"type":"string","enum":["pool_deposited"]}]},"chainId":{"type":"integer"},"chainName":{"type":"string"},"tokenAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"tokenSymbol":{"type":"string"},"decimals":{"minimum":0,"type":"integer"},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"amount":{"description":"Displayed amount in smallest unit","type":"string"},"available":{"description":"Currently available visible amount in smallest unit","type":"string"},"pending":{"description":"Currently pending visible amount in smallest unit","type":"string"},"receiveCount":{"minimum":0,"type":"integer"},"rawReceiveCount":{"minimum":0,"type":"integer"},"trustedReceiveActionCount":{"minimum":0,"type":"integer"},"trustedReceiveActionTypes":{"type":"array","items":{"type":"string"}},"lastReceivedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"receiveTxHash":{"anyOf":[{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},{"type":"null"}]},"usdAmount":{"anyOf":[{"type":"number"},{"type":"null"}]},"pricePerToken":{"anyOf":[{"type":"number"},{"type":"null"}]},"poolMinDeposit":{"anyOf":[{"type":"string"},{"type":"null"}]},"canConvert":{"type":"boolean"},"convertUnavailableReason":{"anyOf":[{"type":"string"},{"type":"null"}]},"poolDeposit":{"anyOf":[{"type":"object","properties":{"commitmentId":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["confirmed"]},{"type":"string","enum":["asp_pending"]},{"type":"string","enum":["approved"]},{"type":"string","enum":["declined"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["cancelled"]}]},"txHash":{"anyOf":[{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},{"type":"null"}]},"amount":{"description":"Pool deposit amount in smallest unit","type":"string"},"updatedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["commitmentId","status","txHash","amount","updatedAt"]},{"type":"null"}]}},"required":["id","address","reviewStatus","statusReason","chainId","chainName","tokenAddress","tokenSymbol","decimals","logoUrl","amount","available","pending","receiveCount","rawReceiveCount","trustedReceiveActionCount","trustedReceiveActionTypes","lastReceivedAt","receiveTxHash","usdAmount","pricePerToken","poolMinDeposit","canConvert","convertUnavailableReason","poolDeposit"]}},"primaryAsset":{"type":"object","properties":{"id":{"type":"string"},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"reviewStatus":{"anyOf":[{"type":"string","enum":["needs_review"]},{"type":"string","enum":["in_progress"]},{"type":"string","enum":["done"]}]},"statusReason":{"anyOf":[{"type":"string","enum":["untagged"]},{"type":"string","enum":["tags_added"]},{"type":"string","enum":["pool_deposit_in_progress"]},{"type":"string","enum":["pool_deposit_rejected"]},{"type":"string","enum":["pool_deposited"]}]},"chainId":{"type":"integer"},"chainName":{"type":"string"},"tokenAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"tokenSymbol":{"type":"string"},"decimals":{"minimum":0,"type":"integer"},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"amount":{"description":"Displayed amount in smallest unit","type":"string"},"available":{"description":"Currently available visible amount in smallest unit","type":"string"},"pending":{"description":"Currently pending visible amount in smallest unit","type":"string"},"receiveCount":{"minimum":0,"type":"integer"},"rawReceiveCount":{"minimum":0,"type":"integer"},"trustedReceiveActionCount":{"minimum":0,"type":"integer"},"trustedReceiveActionTypes":{"type":"array","items":{"type":"string"}},"lastReceivedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"receiveTxHash":{"anyOf":[{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},{"type":"null"}]},"usdAmount":{"anyOf":[{"type":"number"},{"type":"null"}]},"pricePerToken":{"anyOf":[{"type":"number"},{"type":"null"}]},"poolMinDeposit":{"anyOf":[{"type":"string"},{"type":"null"}]},"canConvert":{"type":"boolean"},"convertUnavailableReason":{"anyOf":[{"type":"string"},{"type":"null"}]},"poolDeposit":{"anyOf":[{"type":"object","properties":{"commitmentId":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["confirmed"]},{"type":"string","enum":["asp_pending"]},{"type":"string","enum":["approved"]},{"type":"string","enum":["declined"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["cancelled"]}]},"txHash":{"anyOf":[{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},{"type":"null"}]},"amount":{"description":"Pool deposit amount in smallest unit","type":"string"},"updatedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["commitmentId","status","txHash","amount","updatedAt"]},{"type":"null"}]}},"required":["id","address","reviewStatus","statusReason","chainId","chainName","tokenAddress","tokenSymbol","decimals","logoUrl","amount","available","pending","receiveCount","rawReceiveCount","trustedReceiveActionCount","trustedReceiveActionTypes","lastReceivedAt","receiveTxHash","usdAmount","pricePerToken","poolMinDeposit","canConvert","convertUnavailableReason","poolDeposit"]},"receiveCount":{"minimum":0,"type":"integer"},"rawReceiveCount":{"minimum":0,"type":"integer"},"trustedReceiveActionCount":{"minimum":0,"type":"integer"},"trustedReceiveActionTypes":{"type":"array","items":{"type":"string"}},"assetCount":{"minimum":0,"type":"integer"},"chainCount":{"minimum":0,"type":"integer"},"lastReceivedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"usdAmount":{"anyOf":[{"type":"number"},{"type":"null"}]},"canConvert":{"type":"boolean"}},"required":["id","address","reviewStatus","statusReason","provenanceSources","assets","primaryAsset","receiveCount","rawReceiveCount","trustedReceiveActionCount","trustedReceiveActionTypes","assetCount","chainCount","lastReceivedAt","usdAmount","canConvert"]}},"counts":{"type":"object","properties":{"needsReview":{"minimum":0,"type":"integer"},"inProgress":{"minimum":0,"type":"integer"},"done":{"minimum":0,"type":"integer"}},"required":["needsReview","inProgress","done"]},"pageInfo":{"type":"object","properties":{"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"},"limit":{"minimum":1,"type":"integer"}},"required":["nextCursor","hasMore","limit"]},"unseenNeedsReview":{"minimum":0,"description":"needs-review addresses received after the account last opened Review. Drives the notification badge; 0 once everything current has been seen.","type":"integer"}},"required":["items","counts","pageInfo","unseenNeedsReview"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}},{"status":"403","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Forbidden","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"429","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Too Many Requests","type":"string"},"message":{"example":"Rate limit exceeded. Maximum 60 requests per 1 minute.","type":"string"}},"required":["error","message"]}},{"status":"503","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Service Unavailable","type":"string"},"message":{"type":"string"},"code":{"example":"SERVER_BUSY","description":"Machine-readable reason, such as SERVER_BUSY or POOL_STATE_REFRESHING.","type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### Mark deposit review seen

<EndpointCard data={{"method":"POST","path":"/v1/accounts/{accountId}/deposit-review/seen","operationId":"markDepositReviewSeen","tags":["Balance & Activity"],"description":"Mark the account's deposit-review notifications as seen, clearing the Review badge. Idempotent; the marker only moves forward.","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"seenAt":{"format":"date-time","description":"The persisted \"seen\" marker after this request.","type":"string"}},"required":["seenAt"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}},{"status":"403","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Forbidden","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"429","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Too Many Requests","type":"string"},"message":{"example":"Rate limit exceeded. Maximum 60 requests per 1 minute.","type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

### Transact

Sending, swapping, bridging, converting to incognito, and cashing out all follow the same flow: get a quote, then submit.

#### Get quote signer public key

<EndpointCard data={{"method":"GET","path":"/v1/.well-known/quote-signer-public-key","operationId":"getQuoteSignerPublicKey","tags":["Transact"],"description":"Retrieve the server's P-256 ECDSA public key so clients can verify that quote responses were authentically signed by the server and haven't been tampered with.","parameters":[],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"publicKey":{"example":"04...","type":"string"},"format":{"example":"hex","type":"string"},"curve":{"example":"P-256","type":"string"},"algorithm":{"example":"ECDSA","type":"string"}},"required":["publicKey","format","curve","algorithm"]}}],"requiresAuth":false}} />

#### List supported pools

<EndpointCard data={{"method":"GET","path":"/v1/supported-pools","operationId":"listSupportedPools","tags":["Transact"],"description":"List privacy pools available to the authenticated user, including pool contract addresses, accepted tokens, deposit limits, and ASP (Association Set Provider) details. Feature-flagged pools are only included when the flag is enabled for the account.","parameters":[],"responses":[{"status":"200","description":"Default Response","schema":{"type":"array","items":{"anyOf":[{"additionalProperties":false,"type":"object","properties":{"provider":{"type":"string","enum":["privacy-pools"]},"poolAddress":{"example":"0x...","type":"string"},"chainId":{"example":1,"type":"number"},"chainName":{"example":"Ethereum","type":"string"},"token":{"example":"0x...","type":"string"},"tokenSymbol":{"example":"ETH","type":"string"},"decimals":{"example":18,"type":"number"},"logoUrl":{"example":"https://...","anyOf":[{"type":"string"},{"type":"null"}]},"minDeposit":{"example":"10000000000000000","type":"string"},"maxDeposit":{"example":"100000000000000000000","type":"string"},"totalBalance":{"description":"Total pool balance in smallest unit (stringified bigint), or null if unavailable","example":"2659000000000000000000","anyOf":[{"type":"string"},{"type":"null"}]},"scope":{"description":"Pool scope as a stringified bigint — keccak256(poolAddress, chainId, asset) mod SNARK_SCALAR_FIELD. Used by the client to derive deposit precommitments.","example":"12345678901234567890","type":"string"},"asp":{"type":"object","properties":{"name":{"example":"0xbow","type":"string"},"policyUrl":{"example":"https://0xbow.io/policy","type":"string"}},"required":["name","policyUrl"]},"maxRelayFeeBPS":{"description":"On-chain contract maximum for relayFeeBPS on withdrawals","example":1000,"type":"number"},"withdrawalFeePerProofWei":{"description":"Estimated gas cost in wei for relaying one ZK proof withdrawal (stringified bigint). Refreshed periodically.","example":"95000000000000","type":"string"}},"required":["provider","poolAddress","chainId","chainName","token","tokenSymbol","decimals","logoUrl","minDeposit","maxDeposit","totalBalance","scope","asp","maxRelayFeeBPS","withdrawalFeePerProofWei"]},{"additionalProperties":false,"type":"object","properties":{"provider":{"type":"string","enum":["privacy-boost"]},"poolAddress":{"example":"0x...","type":"string"},"chainId":{"example":1,"type":"number"},"chainName":{"example":"Ethereum","type":"string"},"token":{"example":"0x...","type":"string"},"tokenSymbol":{"example":"ETH","type":"string"},"decimals":{"example":18,"type":"number"},"logoUrl":{"example":"https://...","anyOf":[{"type":"string"},{"type":"null"}]},"minDeposit":{"example":"10000000000000000","type":"string"},"maxDeposit":{"example":"100000000000000000000","type":"string"},"totalBalance":{"description":"Total pool balance in smallest unit (stringified bigint), or null if unavailable","example":"2659000000000000000000","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["provider","poolAddress","chainId","chainName","token","tokenSymbol","decimals","logoUrl","minDeposit","maxDeposit","totalBalance"]}]}}}],"requiresAuth":true}} />

#### Get spendable addresses

<EndpointCard data={{"method":"GET","path":"/v1/accounts/{accountId}/spendable-addresses","operationId":"getSpendableAddresses","tags":["Transact"],"description":"Deprecated. Use GET /address-balances?purpose=funding with chainId and token.","parameters":[{"schema":{"type":"number"},"in":"query","name":"chainId","required":true,"description":"Chain ID (must support Porto)"},{"schema":{"type":"string"},"in":"query","name":"token","required":true,"description":"Token address (0x...)"},{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"provenanceLabelGroups":{"type":"object","additionalProperties":{"type":"object","properties":{"encryptedTagSources":{"description":"Only receive sources with encrypted user tag payloads needed for client-side label display.","type":"array","items":{"type":"object","properties":{"id":{"description":"Stable provenance source key","type":"string"},"kind":{"type":"string","enum":["receive"]},"origin":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"}},"required":["chainId","txHash","transferOrLogIndex"]},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","description":"Owned address where this receive source originally landed","type":"string"},"tagPayloadCiphertext":{"anyOf":[{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","description":"Optional client-encrypted provenance tag payload ciphertext","type":"string"},{"type":"null"}]},"tagPayloadUpdatedAt":{"anyOf":[{"format":"date-time","description":"ISO timestamp for the last provenance tag payload update","type":"string"},{"type":"null"}]},"tagEligibility":{"anyOf":[{"type":"string","enum":["eligible"]},{"type":"string","enum":["received_before_tagging"]}]},"tagEditable":{"description":"True when this receive source is post-launch and may be tagged by the current account","type":"boolean"},"systemTags":{"description":"Server-derived tags based on public onchain facts","type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["pool-receive"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["pool_receive"]},"evidence":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"},"receiveFromAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"entrypointAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolTransferOrLogIndex":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]}},"required":["chainId","txHash","transferOrLogIndex","receiveFromAddress","poolAddress","entrypointAddress","poolTransferOrLogIndex"]}},"required":["type","text","explanationKey","evidence"]},{"type":"object","properties":{"type":{"type":"string","enum":["dapp-used"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["dapp_used"]},"evidence":{"type":"object","properties":{"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"origins":{"type":"array","items":{"type":"object","properties":{"origin":{"type":"string"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastUsedAt":{"format":"date-time","type":"string"}},"required":["origin","displayName","iconUrl","lastUsedAt"]}},"matchedOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestUsedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["address","origins","matchedOrigin","latestUsedAt"]}},"required":["type","text","explanationKey","evidence"]}]}}},"required":["id","kind","origin","address","tagPayloadCiphertext","tagPayloadUpdatedAt","tagEligibility","tagEditable","systemTags"]}},"systemLabels":{"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","enum":["pool_receive"]},{"type":"string","enum":["dapp_used"]}]},"text":{"description":"Short server-derived label text for display","type":"string"},"iconUrl":{"anyOf":[{"description":"Optional safe proxied icon URL for system labels with app metadata","type":"string"},{"type":"null"}]}},"required":["key","text"]}},"hasNoTag":{"description":"True when represented provenance includes at least one untagged source.","type":"boolean"},"hasOlderFunds":{"description":"True when represented provenance includes older/pre-tagging funds.","type":"boolean"},"hasUnknown":{"description":"True when represented provenance includes unresolved provenance.","type":"boolean"}},"required":["encryptedTagSources","systemLabels","hasNoTag","hasOlderFunds","hasUnknown"]}},"spendables":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"token":{"type":"string"},"address":{"type":"string"},"amount":{"description":"Available raw amount in smallest unit","type":"string"},"idCount":{"description":"Number of spendable output IDs represented by this address group","type":"number"},"addressSummary":{"type":"object","properties":{"receiveCount":{"description":"Action-aware inbound receive count. Trusted Cloaked actions that emit multiple transfer logs are counted once.","type":"number"},"rawReceiveCount":{"description":"Literal distinct inbound transfer/log count before trusted-action collapsing.","type":"number"},"trustedReceiveActionCount":{"description":"Number of Cloaked-managed receive actions collapsed into receiveCount.","type":"number"},"trustedReceiveActionTypes":{"type":"array","items":{"type":"string"}},"assetCount":{"description":"Distinct priced/displayable chain-token assets seen for this address","type":"number"},"chainCount":{"description":"Distinct networks with priced/displayable assets at this address","type":"number"},"assets":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"chainName":{"type":"string"},"token":{"type":"string"},"tokenSymbol":{"type":"string"},"decimals":{"type":"number"},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"amount":{"description":"Total raw amount in smallest unit, including unlocked and locked outputs","type":"string"},"usdAmount":{"description":"USD value of the total amount, including unlocked and locked outputs","anyOf":[{"type":"number"},{"type":"null"}]},"pricePerToken":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["chainId","chainName","token","tokenSymbol","decimals","logoUrl","amount","usdAmount","pricePerToken"]}}},"required":["receiveCount","rawReceiveCount","trustedReceiveActionCount","trustedReceiveActionTypes","assetCount","chainCount","assets"]},"provenance":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["resolved"]},{"type":"string","enum":["unavailable"]}]},"sourceLabelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"description":"Number of pre-launch checkpoint provenance markers represented by this balance.","type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}},"displayContext":{"type":"object","properties":{"reason":{"anyOf":[{"type":"string","enum":["fresh_receive"]},{"type":"string","enum":["cloaked_action_output"]},{"type":"string","enum":["mixed_current_outputs"]},{"type":"string","enum":["carried_source"]},{"type":"string","enum":["older_funds"]},{"type":"string","enum":["unavailable"]}]},"currentOutputCount":{"minimum":0,"type":"integer"},"sourceCount":{"minimum":0,"type":"integer"},"actionTypes":{"type":"array","items":{"type":"string"}}},"required":["reason","currentOutputCount","sourceCount","actionTypes"]},"funding":{"type":"object","properties":{"labelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}}},"required":["labelGroupId","olderFundsCount","unresolvedReasons"]},"association":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["clean"]},{"type":"string","enum":["linked"]},{"type":"string","enum":["unknown"]}]},"labelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}},"ignoredUnsolicitedCount":{"minimum":0,"type":"integer"},"summary":{"type":"object","properties":{"sourceCount":{"minimum":0,"type":"integer"},"poolReceiveCount":{"minimum":0,"type":"integer"},"userTaggedSourceCount":{"minimum":0,"type":"integer"},"untaggedSourceCount":{"minimum":0,"type":"integer"},"olderFundsCount":{"minimum":0,"type":"integer"},"unknownCount":{"minimum":0,"type":"integer"}},"required":["sourceCount","poolReceiveCount","userTaggedSourceCount","untaggedSourceCount","olderFundsCount","unknownCount"]}},"required":["status","labelGroupId","olderFundsCount","unresolvedReasons","ignoredUnsolicitedCount","summary"]},"display":{"type":"object","properties":{"badgeKind":{"anyOf":[{"type":"string","enum":["incognito_clean"]},{"type":"string","enum":["tagged"]},{"type":"string","enum":["mixed"]},{"type":"string","enum":["older_funds"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["untagged"]}]},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"fundingLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"associationLabel":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["badgeKind","label","fundingLabel","associationLabel"]},"editableSource":{"description":"The single directly editable receive source for this item, when one exists.","anyOf":[{"type":"object","properties":{"id":{"description":"Stable provenance source key","type":"string"},"kind":{"type":"string","enum":["receive"]},"origin":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"}},"required":["chainId","txHash","transferOrLogIndex"]},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","description":"Owned address where this receive source originally landed","type":"string"},"tagPayloadCiphertext":{"anyOf":[{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","description":"Optional client-encrypted provenance tag payload ciphertext","type":"string"},{"type":"null"}]},"tagPayloadUpdatedAt":{"anyOf":[{"format":"date-time","description":"ISO timestamp for the last provenance tag payload update","type":"string"},{"type":"null"}]},"tagEligibility":{"anyOf":[{"type":"string","enum":["eligible"]},{"type":"string","enum":["received_before_tagging"]}]},"tagEditable":{"description":"True when this receive source is post-launch and may be tagged by the current account","type":"boolean"},"systemTags":{"description":"Server-derived tags based on public onchain facts","type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["pool-receive"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["pool_receive"]},"evidence":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"},"receiveFromAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"entrypointAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolTransferOrLogIndex":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]}},"required":["chainId","txHash","transferOrLogIndex","receiveFromAddress","poolAddress","entrypointAddress","poolTransferOrLogIndex"]}},"required":["type","text","explanationKey","evidence"]},{"type":"object","properties":{"type":{"type":"string","enum":["dapp-used"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["dapp_used"]},"evidence":{"type":"object","properties":{"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"origins":{"type":"array","items":{"type":"object","properties":{"origin":{"type":"string"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastUsedAt":{"format":"date-time","type":"string"}},"required":["origin","displayName","iconUrl","lastUsedAt"]}},"matchedOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestUsedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["address","origins","matchedOrigin","latestUsedAt"]}},"required":["type","text","explanationKey","evidence"]}]}}},"required":["id","kind","origin","address","tagPayloadCiphertext","tagPayloadUpdatedAt","tagEligibility","tagEditable","systemTags"]},{"type":"null"}]}},"required":["status","sourceLabelGroupId","olderFundsCount","unresolvedReasons","displayContext","funding","association","display","editableSource"]},"lastReceivedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["chainId","token","address","amount","idCount","addressSummary","provenance","lastReceivedAt"]}}},"required":["provenanceLabelGroups","spendables"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}},{"status":"403","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Forbidden","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"429","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Too Many Requests","type":"string"},"message":{"example":"Rate limit exceeded. Maximum 60 requests per 1 minute.","type":"string"}},"required":["error","message"]}},{"status":"503","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Service Unavailable","type":"string"},"message":{"type":"string"},"code":{"example":"SERVER_BUSY","description":"Machine-readable reason, such as SERVER_BUSY or POOL_STATE_REFRESHING.","type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### List provenance address tags

<EndpointCard data={{"method":"GET","path":"/v1/accounts/{accountId}/provenance-address-tags","operationId":"listProvenanceAddressTags","tags":["Transact"],"description":"List encrypted display tag payload ciphertexts for owned addresses.","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"tags":{"type":"array","items":{"type":"object","properties":{"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"tagPayloadCiphertext":{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","type":"string"},"tagPayloadUpdatedAt":{"format":"date-time","type":"string"}},"required":["address","tagPayloadCiphertext","tagPayloadUpdatedAt"]}}},"required":["tags"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}},{"status":"403","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Forbidden","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"429","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Too Many Requests","type":"string"},"message":{"example":"Rate limit exceeded. Maximum 60 requests per 1 minute.","type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### Set provenance address tags

<EndpointCard data={{"method":"PUT","path":"/v1/accounts/{accountId}/provenance-address-tags/{address}","operationId":"setProvenanceAddressTags","tags":["Transact"],"description":"Set or clear encrypted display tag payload ciphertext for an owned address.","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"},{"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"in":"path","name":"address","required":true,"description":"Owned address whose private tags should be updated"}],"requestBody":{"required":true,"schema":{"additionalProperties":false,"type":"object","properties":{"tagPayloadCiphertext":{"anyOf":[{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","description":"New encrypted display tag payload ciphertext. Null clears the tags.","type":"string"},{"type":"null"}]}},"required":["tagPayloadCiphertext"]}},"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"tag":{"type":"object","properties":{"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"tagPayloadCiphertext":{"anyOf":[{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}]},"tagPayloadUpdatedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["address","tagPayloadCiphertext","tagPayloadUpdatedAt"]}},"required":["tag"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}},{"status":"403","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Forbidden","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"404","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Not found","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"429","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Too Many Requests","type":"string"},"message":{"example":"Rate limit exceeded. Maximum 60 requests per 1 minute.","type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### Get address balances

<EndpointCard data={{"method":"GET","path":"/v1/accounts/{accountId}/address-balances","operationId":"getAddressBalances","tags":["Transact"],"description":"List address-held balances grouped by address, enriched with token metadata, dApp usage, receive history, and provenance metadata.","parameters":[{"schema":{"deprecated":true,"type":"string","enum":["address"]},"in":"query","name":"view","required":false,"description":"Deprecated compatibility parameter. Omit it; address grouping is the default."},{"schema":{"type":"string","enum":["funding"]},"in":"query","name":"purpose","required":false,"description":"Select addresses with unlocked funds that may fund a transaction, excluding addresses reserved for active Cloakie deposits. Use available for the fundable amount; amount, usdAmount, and totalUsdBalance continue to include locked funds. Requires chainId and token."},{"schema":{"type":"number"},"in":"query","name":"chainId","required":false,"description":"Filter balances to one chain ID"},{"schema":{"type":"string"},"in":"query","name":"token","required":false,"description":"Filter balances to one token address"},{"schema":{"type":"string"},"in":"query","name":"dappOrigin","required":false,"description":"Filter recently-used addresses by this dApp origin"},{"schema":{"minimum":1,"maximum":100,"type":"number"},"in":"query","name":"limit","required":false,"description":"Max addresses to return. Omit to return all."},{"schema":{"minimum":0,"default":0,"type":"number"},"in":"query","name":"offset","required":false},{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"provenanceLabelGroups":{"type":"object","additionalProperties":{"type":"object","properties":{"encryptedTagSources":{"description":"Only receive sources with encrypted user tag payloads needed for client-side label display.","type":"array","items":{"type":"object","properties":{"id":{"description":"Stable provenance source key","type":"string"},"kind":{"type":"string","enum":["receive"]},"origin":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"}},"required":["chainId","txHash","transferOrLogIndex"]},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","description":"Owned address where this receive source originally landed","type":"string"},"tagPayloadCiphertext":{"anyOf":[{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","description":"Optional client-encrypted provenance tag payload ciphertext","type":"string"},{"type":"null"}]},"tagPayloadUpdatedAt":{"anyOf":[{"format":"date-time","description":"ISO timestamp for the last provenance tag payload update","type":"string"},{"type":"null"}]},"tagEligibility":{"anyOf":[{"type":"string","enum":["eligible"]},{"type":"string","enum":["received_before_tagging"]}]},"tagEditable":{"description":"True when this receive source is post-launch and may be tagged by the current account","type":"boolean"},"systemTags":{"description":"Server-derived tags based on public onchain facts","type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["pool-receive"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["pool_receive"]},"evidence":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"},"receiveFromAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"entrypointAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolTransferOrLogIndex":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]}},"required":["chainId","txHash","transferOrLogIndex","receiveFromAddress","poolAddress","entrypointAddress","poolTransferOrLogIndex"]}},"required":["type","text","explanationKey","evidence"]},{"type":"object","properties":{"type":{"type":"string","enum":["dapp-used"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["dapp_used"]},"evidence":{"type":"object","properties":{"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"origins":{"type":"array","items":{"type":"object","properties":{"origin":{"type":"string"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastUsedAt":{"format":"date-time","type":"string"}},"required":["origin","displayName","iconUrl","lastUsedAt"]}},"matchedOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestUsedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["address","origins","matchedOrigin","latestUsedAt"]}},"required":["type","text","explanationKey","evidence"]}]}}},"required":["id","kind","origin","address","tagPayloadCiphertext","tagPayloadUpdatedAt","tagEligibility","tagEditable","systemTags"]}},"systemLabels":{"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","enum":["pool_receive"]},{"type":"string","enum":["dapp_used"]}]},"text":{"description":"Short server-derived label text for display","type":"string"},"iconUrl":{"anyOf":[{"description":"Optional safe proxied icon URL for system labels with app metadata","type":"string"},{"type":"null"}]}},"required":["key","text"]}},"hasNoTag":{"description":"True when represented provenance includes at least one untagged source.","type":"boolean"},"hasOlderFunds":{"description":"True when represented provenance includes older/pre-tagging funds.","type":"boolean"},"hasUnknown":{"description":"True when represented provenance includes unresolved provenance.","type":"boolean"}},"required":["encryptedTagSources","systemLabels","hasNoTag","hasOlderFunds","hasUnknown"]}},"dapp":{"anyOf":[{"type":"object","properties":{"origin":{"type":"string"},"displayName":{"type":"string"},"iconUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"recognitionStatus":{"anyOf":[{"type":"string","enum":["recognized"]},{"type":"string","enum":["blocked"]},{"type":"string","enum":["unrecognized"]}]},"verified":{"type":"boolean"}},"required":["origin","displayName","iconUrl","recognitionStatus","verified"]},{"type":"null"}]},"addresses":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"nonce":{"type":"string"},"usedOrigins":{"type":"array","items":{"type":"string"}},"recentlyUsedByDapp":{"type":"boolean"},"totalUsdBalance":{"description":"USD value of all returned balances, including unlocked and locked outputs","anyOf":[{"type":"number"},{"type":"null"}]},"balances":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"chainName":{"type":"string"},"token":{"type":"string"},"tokenSymbol":{"type":"string"},"decimals":{"type":"number"},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"amount":{"description":"Total raw amount in smallest unit, including unlocked and locked outputs","type":"string"},"available":{"description":"Currently unlocked raw amount in smallest unit","type":"string"},"pending":{"description":"Currently locked raw amount in smallest unit","type":"string"},"usdAmount":{"description":"USD value of the total amount, including unlocked and locked outputs","anyOf":[{"type":"number"},{"type":"null"}]},"pricePerToken":{"anyOf":[{"type":"number"},{"type":"null"}]},"priceStale":{"type":"boolean"},"idCount":{"description":"Number of output IDs represented by this balance; funding mode counts only unlocked outputs","type":"number"},"addressSummary":{"type":"object","properties":{"receiveCount":{"description":"Action-aware inbound receive count. Trusted Cloaked actions that emit multiple transfer logs are counted once.","type":"number"},"rawReceiveCount":{"description":"Literal distinct inbound transfer/log count before trusted-action collapsing.","type":"number"},"trustedReceiveActionCount":{"description":"Number of Cloaked-managed receive actions collapsed into receiveCount.","type":"number"},"trustedReceiveActionTypes":{"type":"array","items":{"type":"string"}},"assetCount":{"description":"Distinct priced/displayable chain-token assets seen for this address","type":"number"},"chainCount":{"description":"Distinct networks with priced/displayable assets at this address","type":"number"},"assets":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"chainName":{"type":"string"},"token":{"type":"string"},"tokenSymbol":{"type":"string"},"decimals":{"type":"number"},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"amount":{"description":"Total raw amount in smallest unit, including unlocked and locked outputs","type":"string"},"usdAmount":{"description":"USD value of the total amount, including unlocked and locked outputs","anyOf":[{"type":"number"},{"type":"null"}]},"pricePerToken":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["chainId","chainName","token","tokenSymbol","decimals","logoUrl","amount","usdAmount","pricePerToken"]}}},"required":["receiveCount","rawReceiveCount","trustedReceiveActionCount","trustedReceiveActionTypes","assetCount","chainCount","assets"]},"provenance":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["resolved"]},{"type":"string","enum":["unavailable"]}]},"sourceLabelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"description":"Number of pre-launch checkpoint provenance markers represented by this balance.","type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}},"displayContext":{"type":"object","properties":{"reason":{"anyOf":[{"type":"string","enum":["fresh_receive"]},{"type":"string","enum":["cloaked_action_output"]},{"type":"string","enum":["mixed_current_outputs"]},{"type":"string","enum":["carried_source"]},{"type":"string","enum":["older_funds"]},{"type":"string","enum":["unavailable"]}]},"currentOutputCount":{"minimum":0,"type":"integer"},"sourceCount":{"minimum":0,"type":"integer"},"actionTypes":{"type":"array","items":{"type":"string"}}},"required":["reason","currentOutputCount","sourceCount","actionTypes"]},"funding":{"type":"object","properties":{"labelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}}},"required":["labelGroupId","olderFundsCount","unresolvedReasons"]},"association":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["clean"]},{"type":"string","enum":["linked"]},{"type":"string","enum":["unknown"]}]},"labelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}},"ignoredUnsolicitedCount":{"minimum":0,"type":"integer"},"summary":{"type":"object","properties":{"sourceCount":{"minimum":0,"type":"integer"},"poolReceiveCount":{"minimum":0,"type":"integer"},"userTaggedSourceCount":{"minimum":0,"type":"integer"},"untaggedSourceCount":{"minimum":0,"type":"integer"},"olderFundsCount":{"minimum":0,"type":"integer"},"unknownCount":{"minimum":0,"type":"integer"}},"required":["sourceCount","poolReceiveCount","userTaggedSourceCount","untaggedSourceCount","olderFundsCount","unknownCount"]}},"required":["status","labelGroupId","olderFundsCount","unresolvedReasons","ignoredUnsolicitedCount","summary"]},"display":{"type":"object","properties":{"badgeKind":{"anyOf":[{"type":"string","enum":["incognito_clean"]},{"type":"string","enum":["tagged"]},{"type":"string","enum":["mixed"]},{"type":"string","enum":["older_funds"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["untagged"]}]},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"fundingLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"associationLabel":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["badgeKind","label","fundingLabel","associationLabel"]},"editableSource":{"description":"The single directly editable receive source for this item, when one exists.","anyOf":[{"type":"object","properties":{"id":{"description":"Stable provenance source key","type":"string"},"kind":{"type":"string","enum":["receive"]},"origin":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"}},"required":["chainId","txHash","transferOrLogIndex"]},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","description":"Owned address where this receive source originally landed","type":"string"},"tagPayloadCiphertext":{"anyOf":[{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","description":"Optional client-encrypted provenance tag payload ciphertext","type":"string"},{"type":"null"}]},"tagPayloadUpdatedAt":{"anyOf":[{"format":"date-time","description":"ISO timestamp for the last provenance tag payload update","type":"string"},{"type":"null"}]},"tagEligibility":{"anyOf":[{"type":"string","enum":["eligible"]},{"type":"string","enum":["received_before_tagging"]}]},"tagEditable":{"description":"True when this receive source is post-launch and may be tagged by the current account","type":"boolean"},"systemTags":{"description":"Server-derived tags based on public onchain facts","type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["pool-receive"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["pool_receive"]},"evidence":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"},"receiveFromAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"entrypointAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolTransferOrLogIndex":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]}},"required":["chainId","txHash","transferOrLogIndex","receiveFromAddress","poolAddress","entrypointAddress","poolTransferOrLogIndex"]}},"required":["type","text","explanationKey","evidence"]},{"type":"object","properties":{"type":{"type":"string","enum":["dapp-used"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["dapp_used"]},"evidence":{"type":"object","properties":{"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"origins":{"type":"array","items":{"type":"object","properties":{"origin":{"type":"string"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastUsedAt":{"format":"date-time","type":"string"}},"required":["origin","displayName","iconUrl","lastUsedAt"]}},"matchedOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestUsedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["address","origins","matchedOrigin","latestUsedAt"]}},"required":["type","text","explanationKey","evidence"]}]}}},"required":["id","kind","origin","address","tagPayloadCiphertext","tagPayloadUpdatedAt","tagEligibility","tagEditable","systemTags"]},{"type":"null"}]}},"required":["status","sourceLabelGroupId","olderFundsCount","unresolvedReasons","displayContext","funding","association","display","editableSource"]},"lastReceivedAt":{"description":"Most recent included output. In funding mode this considers only unlocked outputs.","anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["chainId","chainName","token","tokenSymbol","decimals","logoUrl","amount","available","pending","usdAmount","pricePerToken","priceStale","idCount","addressSummary","provenance","lastReceivedAt"]}}},"required":["address","nonce","usedOrigins","recentlyUsedByDapp","totalUsdBalance","balances"]}},"total":{"description":"Total number of matching addresses before pagination","type":"number"}},"required":["provenanceLabelGroups","dapp","addresses","total"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}},{"status":"403","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Forbidden","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"429","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Too Many Requests","type":"string"},"message":{"example":"Rate limit exceeded. Maximum 60 requests per 1 minute.","type":"string"}},"required":["error","message"]}},{"status":"503","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Service Unavailable","type":"string"},"message":{"type":"string"},"code":{"example":"SERVER_BUSY","description":"Machine-readable reason, such as SERVER_BUSY or POOL_STATE_REFRESHING.","type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### Get cashout market

<EndpointCard data={{"method":"GET","path":"/v1/accounts/{accountId}/cashout/market","operationId":"getCashoutMarket","tags":["Transact"],"description":"Return cashout payment methods ranked for a USD amount and route.","parameters":[{"schema":{"exclusiveMinimum":0,"type":"number"},"in":"query","name":"amountUsd","required":true},{"schema":{"type":"string","enum":["USD"]},"in":"query","name":"currency","required":false},{"schema":{"type":"string"},"in":"query","name":"method","required":false},{"schema":{"exclusiveMinimum":0,"type":"number"},"in":"query","name":"rate","required":false},{"schema":{"anyOf":[{"type":"string","enum":["direct"]},{"type":"string","enum":["swap"]},{"type":"string","enum":["bridge"]}]},"in":"query","name":"route","required":true},{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"methods":{"type":"array","items":{"type":"object","properties":{"method":{"type":"string"},"rank":{"type":"number"},"label":{"type":"string"},"minAmountUsd":{"type":"number"},"presets":{"type":"object","properties":{"fastest":{"type":"string"},"market":{"type":"string"},"bestPayout":{"type":"string"}},"required":["fastest","market","bestPayout"]},"recommendedPreset":{"anyOf":[{"type":"string","enum":["fastest"]},{"type":"string","enum":["market"]},{"type":"string","enum":["bestPayout"]}]},"confidence":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["low"]},{"type":"string","enum":["unknown"]}]},"marketContext":{"anyOf":[{},{"type":"null"}]}},"required":["method","rank","label","minAmountUsd","presets","recommendedPreset","confidence","marketContext"]}}},"required":["methods"]}}],"requiresAuth":true}} />

#### Create quote

<EndpointCard data={{"method":"POST","path":"/v1/accounts/{accountId}/quote","operationId":"createQuote","tags":["Transact"],"description":"Unified quote endpoint. For type=send: reserves balances and returns signing data. For type=swap: reserves balances and returns swap intents via Uniswap.","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"},{"schema":{"type":"string"},"in":"header","name":"idempotency-key","required":false,"description":"Client-generated unique key (e.g. UUID). If the server has already processed a request with this key for the same account and body, it returns the cached response instead of re-executing. Keys expire after 24 hours."}],"requestBody":{"required":false,"schema":{"anyOf":[{"title":"SendQuoteRequest","anyOf":[{"additionalProperties":false,"title":"SingleSendQuoteRequest","type":"object","properties":{"type":{"type":"string","enum":["send"]},"chainId":{"description":"Chain ID (must support Porto)","type":"number"},"token":{"description":"Token address (0x...)","type":"string"},"amount":{"description":"Amount in smallest unit (stringified bigint). Required unless maxSend is true.","type":"string"},"decimals":{"description":"Token decimals (integer 0-255)","type":"number"},"destinationAddress":{"description":"Destination address (0x... or ENS)","type":"string"},"spendableAddresses":{"minItems":1,"maxItems":50,"type":"array","items":{"description":"Optional address-held funding sources to use exactly for this quote.","type":"string"}},"maxSend":{"description":"When true, server computes the maximum sendable amount. Amount field is ignored.","type":"boolean"},"ttl":{"description":"Lock TTL in seconds (default: 86400, max: 86400)","minimum":1,"maximum":86400,"type":"number"}},"required":["type","chainId","token","decimals","destinationAddress"]},{"additionalProperties":false,"title":"BatchSendQuoteRequest","type":"object","properties":{"type":{"type":"string","enum":["send"]},"chainId":{"description":"Chain ID (must support Porto)","type":"number"},"destinationAddress":{"description":"Destination address (0x... or ENS)","type":"string"},"assets":{"type":"array","items":{"additionalProperties":false,"title":"BatchSendAsset","type":"object","properties":{"chainId":{"description":"Optional per-asset chain ID. When present it must match the top-level chainId.","type":"number"},"token":{"description":"Token address (0x...)","type":"string"},"amount":{"description":"Amount in smallest unit (stringified bigint).","type":"string"},"decimals":{"description":"Token decimals (integer 0-255)","type":"number"},"spendableAddresses":{"type":"array","items":{"description":"Address-held funding sources to use exactly for this asset.","type":"string"}}},"required":["token","amount","decimals"]}},"ttl":{"description":"Lock TTL in seconds (default: 86400, max: 86400)","minimum":1,"maximum":86400,"type":"number"}},"required":["type","chainId","destinationAddress","assets"]}]},{"additionalProperties":false,"title":"SwapQuoteRequest","type":"object","properties":{"type":{"type":"string","enum":["swap"]},"chainId":{"description":"Chain ID","type":"number"},"tokenIn":{"description":"Token address being sold","type":"string"},"tokenOut":{"description":"Token address being bought","type":"string"},"amountIn":{"description":"Amount to swap in smallest unit (stringified bigint). Required unless maxSend is true.","type":"string"},"slippageMode":{"description":"Slippage selection mode. auto asks the route provider to calculate slippage; manual uses slippageBps. Responses omit slippageBps when the route has no explicit slippage value.","anyOf":[{"type":"string","enum":["auto"]},{"type":"string","enum":["manual"]}]},"slippageBps":{"description":"Manual slippage tolerance in basis points (e.g. 50 = 0.5%, max: 500 = 5%)","minimum":1,"maximum":500,"type":"number"},"tokenOutChainId":{"description":"Destination chain ID for cross-chain swaps","type":"number"},"maxSend":{"description":"When true, server computes max swappable amount. amountIn is ignored.","type":"boolean"},"spendableAddresses":{"minItems":1,"maxItems":50,"type":"array","items":{"description":"Optional address-held funding sources to use exactly for this swap.","type":"string"}}},"required":["type","chainId","tokenIn","tokenOut"]},{"additionalProperties":false,"title":"ConvertRequest","type":"object","properties":{"type":{"type":"string","enum":["pool-deposit"]},"chainId":{"description":"Chain ID where the privacy pool lives","type":"number"},"token":{"description":"Token address to deposit (0x...)","type":"string"},"amount":{"description":"Deposit amount in smallest unit (stringified bigint). Required unless maxSend is true.","type":"string"},"decimals":{"description":"Token decimals (0-255)","minimum":0,"maximum":255,"type":"number"},"precommitment":{"description":"Precommitment hash (stringified bigint) binding the deposit secrets without revealing them","type":"string"},"nullifierHash":{"description":"Hash of the commitment nullifier (stringified bigint). Lets the server cross-reference on-chain spends.","type":"string"},"depositIndex":{"description":"Client-derived deposit index used for precommitment derivation. Falls back to server-computed index if omitted.","minimum":0,"type":"number"},"maxSend":{"description":"When true, server computes max deposit amount atomically. Amount field is ignored.","type":"boolean"},"spendableAddresses":{"minItems":1,"maxItems":50,"type":"array","items":{"description":"Optional address-held funding sources to use exactly for this pool deposit.","type":"string"}}},"required":["type","chainId","token","decimals","precommitment","nullifierHash"]},{"additionalProperties":false,"title":"PoolWithdrawQuoteRequest","type":"object","properties":{"type":{"type":"string","enum":["pool-withdraw"]},"chainId":{"description":"Chain ID where the privacy pool lives","type":"number"},"token":{"description":"Token address to withdraw (0x...)","type":"string"},"amount":{"description":"Amount in smallest unit (stringified bigint)","type":"string"},"amountMode":{"description":"Whether amount is the gross pool withdrawal amount or exact post-fee receive amount.","anyOf":[{"type":"string","enum":["withdrawal"]},{"type":"string","enum":["receive"]}]},"maxSend":{"description":"Whether this quote should spend the selected commitments as a max flow.","type":"boolean"},"decimals":{"description":"Token decimals (0-255)","minimum":0,"maximum":255,"type":"number"},"destinationAddress":{"description":"Recipient of the withdrawn funds: your own active clkd.eth name for a self-withdrawal (a fresh owned address is minted), or any 0x address / ENS / clkd.eth name for an incognito send to a third party.","type":"string"},"commitmentId":{"format":"uuid","description":"Incognito balance commitment id to withdraw from.","type":"string"}},"required":["type","chainId","token","amount","decimals","destinationAddress","commitmentId"]},{"additionalProperties":false,"title":"ConversionRecoverRequest","type":"object","properties":{"type":{"type":"string","enum":["pool-recover"]},"chainId":{"description":"Chain ID where the privacy pool lives","type":"number"},"token":{"description":"Token address (0x...)","type":"string"},"commitmentId":{"description":"DB ID of the declined commitment to recover","type":"string"}},"required":["type","chainId","token","commitmentId"]},{"additionalProperties":false,"title":"BoostDepositQuoteRequest","type":"object","properties":{"type":{"type":"string","enum":["boost-deposit"]},"chainId":{"description":"Chain ID where the Privacy Boost pool lives","type":"number"},"token":{"description":"Source token to deposit (native sentinel for ETH)","type":"string"},"amount":{"description":"Deposit amount in smallest unit (stringified bigint)","type":"string"},"decimals":{"description":"Token decimals (0-255)","minimum":0,"maximum":255,"type":"number"}},"required":["type","chainId","token","amount","decimals"]},{"additionalProperties":false,"title":"DappCallQuoteRequest","type":"object","properties":{"type":{"type":"string","enum":["dapp-call"]},"chainId":{"description":"Chain ID to execute on","type":"number"},"address":{"description":"Stealth address to execute from (0x...)","type":"string"},"calls":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"to":{"description":"Target contract address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"value":{"description":"ETH value in wei (hex or decimal string)","pattern":"^(0x[a-fA-F0-9]+|[0-9]+)$","type":"string"},"data":{"description":"Calldata (hex string)","pattern":"^0x[a-fA-F0-9]*$","type":"string"}},"required":["to","value","data"]}},"dappOrigin":{"description":"Origin hostname of the dApp (e.g. app.uniswap.org)","maxLength":255,"type":"string"},"dappMetadata":{"additionalProperties":false,"type":"object","properties":{"displayName":{"maxLength":255,"type":"string"},"iconUrl":{"maxLength":2048,"type":"string"},"iconSource":{"maxLength":64,"type":"string"}}},"feePaymentToken":{"description":"Token selected by the user to reimburse relay fees for this dApp call. Native token sentinel or ERC20 address.","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},"required":["type","chainId","address","calls","feePaymentToken"]},{"additionalProperties":false,"title":"OffRampQuoteRequest","type":"object","properties":{"type":{"type":"string","enum":["off-ramp"]},"chainId":{"description":"Source chain ID (8453 for Base, 1 for Ethereum)","type":"number"},"token":{"description":"Source token address (0x...)","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"amount":{"description":"Source-token amount in smallest units. Required unless maxSend is true. Fees are stacked on top and never reduce this amount.","pattern":"^[0-9]+$","type":"string"},"decimals":{"description":"Token decimals","minimum":0,"maximum":255,"type":"number"},"paymentMethod":{"description":"Payment method (venmo, revolut, wise, etc.) — server derives paymentMethodHash from this.","maxLength":50,"type":"string"},"payeeDetailsHash":{"description":"Hashed curator payee ID (no raw PII). Stays client-side for privacy.","maxLength":66,"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"conversionRate":{"description":"USDC-to-fiat conversion rate","exclusiveMinimum":0,"type":"number"},"minConversionRate":{"description":"Peer escrow minConversionRate scaled to 1e18. Advanced callers may send this directly.","pattern":"^[0-9]+$","type":"string"},"maxSend":{"description":"When true, the selected off-ramp route computes maximum cash-out.","type":"boolean"},"spendableAddresses":{"minItems":1,"maxItems":50,"type":"array","items":{"description":"Optional address-held funding sources to use exactly for this cash out.","type":"string"}}},"required":["type","chainId","token","decimals","paymentMethod","payeeDetailsHash"]},{"additionalProperties":false,"title":"OffRampCancelQuoteRequest","type":"object","properties":{"type":{"type":"string","enum":["off-ramp-cancel"]},"peerDepositId":{"description":"UUID of the peer_deposit to cancel","type":"string"}},"required":["type","peerDepositId"]}]}},"responses":[{"status":"200","description":"Default Response","schema":{"anyOf":[{"title":"SwapQuoteResponse","type":"object","properties":{"intents":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"eoa":{"type":"string"},"executionData":{"type":"string"},"nonce":{"type":"string"},"derivationNonce":{"type":"string"},"payer":{"type":"string"},"paymentToken":{"type":"string"},"paymentMaxAmount":{"type":"string"},"combinedGas":{"type":"string"},"encodedPreCalls":{"type":"array","items":{"type":"string"}},"encodedFundTransfers":{"type":"array","items":{"type":"string"}},"settler":{"type":"string"},"expiry":{"type":"string"},"isMultichain":{"type":"boolean"},"funder":{"type":"string"},"funderSignature":{"type":"string"},"settlerContext":{"type":"string"},"paymentAmount":{"type":"string"},"paymentRecipient":{"type":"string"},"paymentSignature":{"type":"string"},"supportedAccountImplementation":{"type":"string"},"domain":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"chainId":{"type":"number"},"verifyingContract":{"type":"string"}},"required":["name","version","chainId","verifyingContract"]},"types":{"description":"EIP-712 type definitions"},"primaryType":{"type":"string","enum":["Intent"]}},"required":["chainId","eoa","executionData","nonce","derivationNonce","payer","paymentToken","paymentMaxAmount","combinedGas","encodedPreCalls","encodedFundTransfers","settler","expiry","isMultichain","funder","funderSignature","settlerContext","paymentAmount","paymentRecipient","paymentSignature","supportedAccountImplementation","domain","types","primaryType"]}},"delegations":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"address":{"type":"string"},"contractAddress":{"type":"string"},"derivationNonce":{"type":"number"},"authorizationNonce":{"type":"number"}},"required":["chainId","address","contractAddress","derivationNonce","authorizationNonce"]}},"quoteId":{"type":"string"},"expiresAt":{"type":"string"},"signature":{"type":"string"},"expectedOutput":{"type":"string"},"minimumOutput":{"type":"string"},"outputToken":{"type":"string"},"outputDecimals":{"type":"number"},"outputSymbol":{"type":"string"},"outputRecipient":{"type":"string"},"slippageMode":{"anyOf":[{"type":"string","enum":["auto"]},{"type":"string","enum":["manual"]}]},"slippageBps":{"description":"Effective slippage tolerance in basis points. Omitted when the route has no explicit slippage value.","type":"number"},"requestedSlippageBps":{"type":"number"},"routing":{"type":"string"},"bridgeProvider":{"anyOf":[{"type":"string","enum":["uniswap"]},{"type":"string","enum":["across"]}]},"protocolFeeBps":{"type":"number"},"protocolFeeAmount":{"type":"string"},"amountIn":{"type":"string"},"selectedFundingSources":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"token":{"type":"string"},"address":{"type":"string"},"amount":{"description":"Raw selected amount in smallest unit","type":"string"},"idCount":{"description":"Number of spendable output IDs represented by this selected funding source","type":"number"},"addressSummary":{"type":"object","properties":{"receiveCount":{"description":"Action-aware inbound receive count. Trusted Cloaked actions that emit multiple transfer logs are counted once.","type":"number"},"rawReceiveCount":{"description":"Literal distinct inbound transfer/log count before trusted-action collapsing.","type":"number"},"trustedReceiveActionCount":{"description":"Number of Cloaked-managed receive actions collapsed into receiveCount.","type":"number"},"trustedReceiveActionTypes":{"type":"array","items":{"type":"string"}},"assetCount":{"description":"Distinct chain-token assets seen for this address.","type":"number"},"chainCount":{"description":"Distinct networks seen for this address.","type":"number"}},"required":["receiveCount","rawReceiveCount","trustedReceiveActionCount","trustedReceiveActionTypes","assetCount","chainCount"]},"provenance":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["resolved"]},{"type":"string","enum":["unavailable"]}]},"sourceLabelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"description":"Number of pre-launch checkpoint provenance markers represented by this balance.","type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}},"displayContext":{"type":"object","properties":{"reason":{"anyOf":[{"type":"string","enum":["fresh_receive"]},{"type":"string","enum":["cloaked_action_output"]},{"type":"string","enum":["mixed_current_outputs"]},{"type":"string","enum":["carried_source"]},{"type":"string","enum":["older_funds"]},{"type":"string","enum":["unavailable"]}]},"currentOutputCount":{"minimum":0,"type":"integer"},"sourceCount":{"minimum":0,"type":"integer"},"actionTypes":{"type":"array","items":{"type":"string"}}},"required":["reason","currentOutputCount","sourceCount","actionTypes"]},"funding":{"type":"object","properties":{"labelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}}},"required":["labelGroupId","olderFundsCount","unresolvedReasons"]},"association":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["clean"]},{"type":"string","enum":["linked"]},{"type":"string","enum":["unknown"]}]},"labelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}},"ignoredUnsolicitedCount":{"minimum":0,"type":"integer"},"summary":{"type":"object","properties":{"sourceCount":{"minimum":0,"type":"integer"},"poolReceiveCount":{"minimum":0,"type":"integer"},"userTaggedSourceCount":{"minimum":0,"type":"integer"},"untaggedSourceCount":{"minimum":0,"type":"integer"},"olderFundsCount":{"minimum":0,"type":"integer"},"unknownCount":{"minimum":0,"type":"integer"}},"required":["sourceCount","poolReceiveCount","userTaggedSourceCount","untaggedSourceCount","olderFundsCount","unknownCount"]}},"required":["status","labelGroupId","olderFundsCount","unresolvedReasons","ignoredUnsolicitedCount","summary"]},"display":{"type":"object","properties":{"badgeKind":{"anyOf":[{"type":"string","enum":["incognito_clean"]},{"type":"string","enum":["tagged"]},{"type":"string","enum":["mixed"]},{"type":"string","enum":["older_funds"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["untagged"]}]},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"fundingLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"associationLabel":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["badgeKind","label","fundingLabel","associationLabel"]},"editableSource":{"description":"The single directly editable receive source for this item, when one exists.","anyOf":[{"type":"object","properties":{"id":{"description":"Stable provenance source key","type":"string"},"kind":{"type":"string","enum":["receive"]},"origin":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"}},"required":["chainId","txHash","transferOrLogIndex"]},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","description":"Owned address where this receive source originally landed","type":"string"},"tagPayloadCiphertext":{"anyOf":[{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","description":"Optional client-encrypted provenance tag payload ciphertext","type":"string"},{"type":"null"}]},"tagPayloadUpdatedAt":{"anyOf":[{"format":"date-time","description":"ISO timestamp for the last provenance tag payload update","type":"string"},{"type":"null"}]},"tagEligibility":{"anyOf":[{"type":"string","enum":["eligible"]},{"type":"string","enum":["received_before_tagging"]}]},"tagEditable":{"description":"True when this receive source is post-launch and may be tagged by the current account","type":"boolean"},"systemTags":{"description":"Server-derived tags based on public onchain facts","type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["pool-receive"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["pool_receive"]},"evidence":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"},"receiveFromAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"entrypointAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolTransferOrLogIndex":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]}},"required":["chainId","txHash","transferOrLogIndex","receiveFromAddress","poolAddress","entrypointAddress","poolTransferOrLogIndex"]}},"required":["type","text","explanationKey","evidence"]},{"type":"object","properties":{"type":{"type":"string","enum":["dapp-used"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["dapp_used"]},"evidence":{"type":"object","properties":{"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"origins":{"type":"array","items":{"type":"object","properties":{"origin":{"type":"string"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastUsedAt":{"format":"date-time","type":"string"}},"required":["origin","displayName","iconUrl","lastUsedAt"]}},"matchedOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestUsedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["address","origins","matchedOrigin","latestUsedAt"]}},"required":["type","text","explanationKey","evidence"]}]}}},"required":["id","kind","origin","address","tagPayloadCiphertext","tagPayloadUpdatedAt","tagEligibility","tagEditable","systemTags"]},{"type":"null"}]}},"required":["status","sourceLabelGroupId","olderFundsCount","unresolvedReasons","displayContext","funding","association","display","editableSource"]}},"required":["chainId","token","address","amount","idCount","addressSummary","provenance"]}},"provenanceLabelGroups":{"type":"object","additionalProperties":{"type":"object","properties":{"encryptedTagSources":{"description":"Only receive sources with encrypted user tag payloads needed for client-side label display.","type":"array","items":{"type":"object","properties":{"id":{"description":"Stable provenance source key","type":"string"},"kind":{"type":"string","enum":["receive"]},"origin":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"}},"required":["chainId","txHash","transferOrLogIndex"]},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","description":"Owned address where this receive source originally landed","type":"string"},"tagPayloadCiphertext":{"anyOf":[{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","description":"Optional client-encrypted provenance tag payload ciphertext","type":"string"},{"type":"null"}]},"tagPayloadUpdatedAt":{"anyOf":[{"format":"date-time","description":"ISO timestamp for the last provenance tag payload update","type":"string"},{"type":"null"}]},"tagEligibility":{"anyOf":[{"type":"string","enum":["eligible"]},{"type":"string","enum":["received_before_tagging"]}]},"tagEditable":{"description":"True when this receive source is post-launch and may be tagged by the current account","type":"boolean"},"systemTags":{"description":"Server-derived tags based on public onchain facts","type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["pool-receive"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["pool_receive"]},"evidence":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"},"receiveFromAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"entrypointAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolTransferOrLogIndex":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]}},"required":["chainId","txHash","transferOrLogIndex","receiveFromAddress","poolAddress","entrypointAddress","poolTransferOrLogIndex"]}},"required":["type","text","explanationKey","evidence"]},{"type":"object","properties":{"type":{"type":"string","enum":["dapp-used"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["dapp_used"]},"evidence":{"type":"object","properties":{"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"origins":{"type":"array","items":{"type":"object","properties":{"origin":{"type":"string"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastUsedAt":{"format":"date-time","type":"string"}},"required":["origin","displayName","iconUrl","lastUsedAt"]}},"matchedOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestUsedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["address","origins","matchedOrigin","latestUsedAt"]}},"required":["type","text","explanationKey","evidence"]}]}}},"required":["id","kind","origin","address","tagPayloadCiphertext","tagPayloadUpdatedAt","tagEligibility","tagEditable","systemTags"]}},"systemLabels":{"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","enum":["pool_receive"]},{"type":"string","enum":["dapp_used"]}]},"text":{"description":"Short server-derived label text for display","type":"string"},"iconUrl":{"anyOf":[{"description":"Optional safe proxied icon URL for system labels with app metadata","type":"string"},{"type":"null"}]}},"required":["key","text"]}},"hasNoTag":{"description":"True when represented provenance includes at least one untagged source.","type":"boolean"},"hasOlderFunds":{"description":"True when represented provenance includes older/pre-tagging funds.","type":"boolean"},"hasUnknown":{"description":"True when represented provenance includes unresolved provenance.","type":"boolean"}},"required":["encryptedTagSources","systemLabels","hasNoTag","hasOlderFunds","hasUnknown"]}},"priceImpact":{"type":"number"},"estimatedFillTimeMs":{"type":"number"},"fillDeadline":{"type":"number"},"planId":{"description":"Bridge routing plan identifier from Across protocol, present only for cross-chain (CHAINED) quotes","type":"string"},"fees":{"type":"object","properties":{"network":{"description":"Gas/relay fee in wei (gas cost only, excludes dust)","type":"string"},"dust":{"description":"Residual balance below the dust threshold swept into the relayer payment. Not a gas fee — included in total but not in network.","type":"string"},"service":{"description":"Protocol fees in wei (vetting + cloaked, or swap protocol fee)","type":"string"},"networkUsdAmount":{"description":"USD value of the network fee, or null when USD pricing is unavailable","anyOf":[{"type":"number"},{"type":"null"}]},"totalUsdAmount":{"description":"USD value of the total fee, or null when USD pricing is unavailable","anyOf":[{"type":"number"},{"type":"null"}]},"vetting":{"description":"On-chain vetting fee in wei (pool deposits only)","type":"string"},"deposit":{"description":"Cloaked deposit fee in wei (pool deposits only)","type":"string"},"total":{"description":"Total fees in wei (network + dust + service)","type":"string"},"waived":{"description":"True when fees are waived (e.g. Cloakie holder on swaps)","type":"boolean"}},"required":["network","service","total"]}},"required":["intents","delegations","quoteId","expiresAt","signature","expectedOutput","minimumOutput","outputToken","outputDecimals","outputSymbol","outputRecipient","slippageMode","routing","protocolFeeBps","protocolFeeAmount","amountIn","fees"]},{"title":"ConversionRecoverResponse","type":"object","properties":{"quoteId":{"type":"string"},"expiresAt":{"type":"string"},"signature":{"type":"string"},"poolAddress":{"type":"string"},"commitment":{"type":"object","properties":{"id":{"type":"string"},"depositIndex":{"type":"number"},"withdrawalIndex":{"type":"number"},"commitment":{"type":"string"},"label":{"type":"string"},"value":{"type":"string"}},"required":["id","depositIndex","withdrawalIndex","commitment","label","value"]},"depositorAddress":{"description":"Stealth address that made the original deposit (msg.sender for ragequit).","type":"string"}},"required":["quoteId","expiresAt","signature","poolAddress","commitment","depositorAddress"]},{"title":"IncognitoSendResponse","type":"object","properties":{"quoteId":{"type":"string"},"expiresAt":{"type":"string"},"signature":{"type":"string"},"poolAddress":{"type":"string"},"resolvedDestination":{"type":"string"},"destinationAddressNonce":{"description":"Nonce used to derive the generated self-withdraw destination address.","anyOf":[{"type":"string"},{"type":"null"}]},"destinationAvatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"selfSend":{"type":"boolean"},"feeRecipient":{"description":"Address to receive relay fees","type":"string"},"relayFeeBPS":{"description":"Definitive relay fee BPS for this set of commitments. Client bakes into each proof.","type":"number"},"feePerProof":{"description":"Estimated fee per ZK proof relay in the pool token units (stringified bigint)","type":"string"},"maxRelayFeeBPS":{"description":"On-chain contract maximum for relayFeeBPS","type":"number"},"withdrawalAmount":{"description":"Gross amount proven to the pool before relay fees are deducted.","type":"string"},"receiveAmount":{"description":"Amount delivered to the recipient after relay fees are deducted.","type":"string"},"amountMode":{"description":"Whether amount was quoted as a gross withdrawal amount or exact post-fee receive amount.","anyOf":[{"type":"string","enum":["withdrawal"]},{"type":"string","enum":["receive"]}]},"commitments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"depositIndex":{"type":"number"},"withdrawalIndex":{"type":"number"},"commitment":{"type":"string"},"label":{"type":"string"},"value":{"type":"string"},"withdrawalAmount":{"type":"string"},"pooledSince":{"description":"ISO timestamp when the ASP approved this commitment (entered the anonymity set)","type":"string"}},"required":["id","depositIndex","withdrawalIndex","commitment","label","value","withdrawalAmount","pooledSince"]}},"fees":{"type":"object","properties":{"network":{"description":"Gas/relay fee in wei (gas cost only, excludes dust)","type":"string"},"dust":{"description":"Residual balance below the dust threshold swept into the relayer payment. Not a gas fee — included in total but not in network.","type":"string"},"service":{"description":"Protocol fees in wei (vetting + cloaked, or swap protocol fee)","type":"string"},"networkUsdAmount":{"description":"USD value of the network fee, or null when USD pricing is unavailable","anyOf":[{"type":"number"},{"type":"null"}]},"totalUsdAmount":{"description":"USD value of the total fee, or null when USD pricing is unavailable","anyOf":[{"type":"number"},{"type":"null"}]},"vetting":{"description":"On-chain vetting fee in wei (pool deposits only)","type":"string"},"deposit":{"description":"Cloaked deposit fee in wei (pool deposits only)","type":"string"},"total":{"description":"Total fees in wei (network + dust + service)","type":"string"},"waived":{"description":"True when fees are waived (e.g. Cloakie holder on swaps)","type":"boolean"}},"required":["network","service","total"]}},"required":["quoteId","expiresAt","signature","poolAddress","resolvedDestination","destinationAvatarUrl","selfSend","feeRecipient","relayFeeBPS","feePerProof","maxRelayFeeBPS","withdrawalAmount","receiveAmount","amountMode","commitments","fees"]},{"title":"ConvertResponse","type":"object","properties":{"intents":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"eoa":{"type":"string"},"executionData":{"type":"string"},"nonce":{"type":"string"},"derivationNonce":{"type":"string"},"payer":{"type":"string"},"paymentToken":{"type":"string"},"paymentMaxAmount":{"type":"string"},"combinedGas":{"type":"string"},"encodedPreCalls":{"type":"array","items":{"type":"string"}},"encodedFundTransfers":{"type":"array","items":{"type":"string"}},"settler":{"type":"string"},"expiry":{"type":"string"},"isMultichain":{"type":"boolean"},"funder":{"type":"string"},"funderSignature":{"type":"string"},"settlerContext":{"type":"string"},"paymentAmount":{"type":"string"},"paymentRecipient":{"type":"string"},"paymentSignature":{"type":"string"},"supportedAccountImplementation":{"type":"string"},"domain":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"chainId":{"type":"number"},"verifyingContract":{"type":"string"}},"required":["name","version","chainId","verifyingContract"]},"types":{"description":"EIP-712 type definitions"},"primaryType":{"type":"string","enum":["Intent"]}},"required":["chainId","eoa","executionData","nonce","derivationNonce","payer","paymentToken","paymentMaxAmount","combinedGas","encodedPreCalls","encodedFundTransfers","settler","expiry","isMultichain","funder","funderSignature","settlerContext","paymentAmount","paymentRecipient","paymentSignature","supportedAccountImplementation","domain","types","primaryType"]}},"delegations":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"address":{"type":"string"},"contractAddress":{"type":"string"},"derivationNonce":{"type":"number"},"authorizationNonce":{"type":"number"}},"required":["chainId","address","contractAddress","derivationNonce","authorizationNonce"]}},"quoteId":{"type":"string"},"expiresAt":{"type":"string"},"signature":{"type":"string"},"poolAddress":{"type":"string"},"depositIndex":{"type":"number"},"grossAmount":{"description":"Total ETH sent to entrypoint (amount + vetting fee)","type":"string"},"feeAmount":{"description":"Vetting fee deducted by the pool","type":"string"},"feeBps":{"description":"Vetting fee in basis points","type":"number"},"netPoolValue":{"description":"Net value credited to the pool commitment","type":"string"},"cloakedFeeBps":{"description":"Cloaked protocol fee rate in basis points","type":"number"},"cloakedFlatFee":{"description":"Flat fee floor in wei for the Cloaked deposit fee","type":"string"},"cloakieFeeMode":{"description":"Legacy fee mode: flat when the Cloaked deposit fee is waived, otherwise standard","anyOf":[{"type":"string","enum":["flat"]},{"type":"string","enum":["standard"]}]},"selectedFundingSources":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"token":{"type":"string"},"address":{"type":"string"},"amount":{"description":"Raw selected amount in smallest unit","type":"string"},"idCount":{"description":"Number of spendable output IDs represented by this selected funding source","type":"number"},"addressSummary":{"type":"object","properties":{"receiveCount":{"description":"Action-aware inbound receive count. Trusted Cloaked actions that emit multiple transfer logs are counted once.","type":"number"},"rawReceiveCount":{"description":"Literal distinct inbound transfer/log count before trusted-action collapsing.","type":"number"},"trustedReceiveActionCount":{"description":"Number of Cloaked-managed receive actions collapsed into receiveCount.","type":"number"},"trustedReceiveActionTypes":{"type":"array","items":{"type":"string"}},"assetCount":{"description":"Distinct chain-token assets seen for this address.","type":"number"},"chainCount":{"description":"Distinct networks seen for this address.","type":"number"}},"required":["receiveCount","rawReceiveCount","trustedReceiveActionCount","trustedReceiveActionTypes","assetCount","chainCount"]},"provenance":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["resolved"]},{"type":"string","enum":["unavailable"]}]},"sourceLabelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"description":"Number of pre-launch checkpoint provenance markers represented by this balance.","type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}},"displayContext":{"type":"object","properties":{"reason":{"anyOf":[{"type":"string","enum":["fresh_receive"]},{"type":"string","enum":["cloaked_action_output"]},{"type":"string","enum":["mixed_current_outputs"]},{"type":"string","enum":["carried_source"]},{"type":"string","enum":["older_funds"]},{"type":"string","enum":["unavailable"]}]},"currentOutputCount":{"minimum":0,"type":"integer"},"sourceCount":{"minimum":0,"type":"integer"},"actionTypes":{"type":"array","items":{"type":"string"}}},"required":["reason","currentOutputCount","sourceCount","actionTypes"]},"funding":{"type":"object","properties":{"labelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}}},"required":["labelGroupId","olderFundsCount","unresolvedReasons"]},"association":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["clean"]},{"type":"string","enum":["linked"]},{"type":"string","enum":["unknown"]}]},"labelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}},"ignoredUnsolicitedCount":{"minimum":0,"type":"integer"},"summary":{"type":"object","properties":{"sourceCount":{"minimum":0,"type":"integer"},"poolReceiveCount":{"minimum":0,"type":"integer"},"userTaggedSourceCount":{"minimum":0,"type":"integer"},"untaggedSourceCount":{"minimum":0,"type":"integer"},"olderFundsCount":{"minimum":0,"type":"integer"},"unknownCount":{"minimum":0,"type":"integer"}},"required":["sourceCount","poolReceiveCount","userTaggedSourceCount","untaggedSourceCount","olderFundsCount","unknownCount"]}},"required":["status","labelGroupId","olderFundsCount","unresolvedReasons","ignoredUnsolicitedCount","summary"]},"display":{"type":"object","properties":{"badgeKind":{"anyOf":[{"type":"string","enum":["incognito_clean"]},{"type":"string","enum":["tagged"]},{"type":"string","enum":["mixed"]},{"type":"string","enum":["older_funds"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["untagged"]}]},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"fundingLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"associationLabel":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["badgeKind","label","fundingLabel","associationLabel"]},"editableSource":{"description":"The single directly editable receive source for this item, when one exists.","anyOf":[{"type":"object","properties":{"id":{"description":"Stable provenance source key","type":"string"},"kind":{"type":"string","enum":["receive"]},"origin":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"}},"required":["chainId","txHash","transferOrLogIndex"]},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","description":"Owned address where this receive source originally landed","type":"string"},"tagPayloadCiphertext":{"anyOf":[{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","description":"Optional client-encrypted provenance tag payload ciphertext","type":"string"},{"type":"null"}]},"tagPayloadUpdatedAt":{"anyOf":[{"format":"date-time","description":"ISO timestamp for the last provenance tag payload update","type":"string"},{"type":"null"}]},"tagEligibility":{"anyOf":[{"type":"string","enum":["eligible"]},{"type":"string","enum":["received_before_tagging"]}]},"tagEditable":{"description":"True when this receive source is post-launch and may be tagged by the current account","type":"boolean"},"systemTags":{"description":"Server-derived tags based on public onchain facts","type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["pool-receive"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["pool_receive"]},"evidence":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"},"receiveFromAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"entrypointAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolTransferOrLogIndex":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]}},"required":["chainId","txHash","transferOrLogIndex","receiveFromAddress","poolAddress","entrypointAddress","poolTransferOrLogIndex"]}},"required":["type","text","explanationKey","evidence"]},{"type":"object","properties":{"type":{"type":"string","enum":["dapp-used"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["dapp_used"]},"evidence":{"type":"object","properties":{"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"origins":{"type":"array","items":{"type":"object","properties":{"origin":{"type":"string"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastUsedAt":{"format":"date-time","type":"string"}},"required":["origin","displayName","iconUrl","lastUsedAt"]}},"matchedOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestUsedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["address","origins","matchedOrigin","latestUsedAt"]}},"required":["type","text","explanationKey","evidence"]}]}}},"required":["id","kind","origin","address","tagPayloadCiphertext","tagPayloadUpdatedAt","tagEligibility","tagEditable","systemTags"]},{"type":"null"}]}},"required":["status","sourceLabelGroupId","olderFundsCount","unresolvedReasons","displayContext","funding","association","display","editableSource"]}},"required":["chainId","token","address","amount","idCount","addressSummary","provenance"]}},"provenanceLabelGroups":{"type":"object","additionalProperties":{"type":"object","properties":{"encryptedTagSources":{"description":"Only receive sources with encrypted user tag payloads needed for client-side label display.","type":"array","items":{"type":"object","properties":{"id":{"description":"Stable provenance source key","type":"string"},"kind":{"type":"string","enum":["receive"]},"origin":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"}},"required":["chainId","txHash","transferOrLogIndex"]},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","description":"Owned address where this receive source originally landed","type":"string"},"tagPayloadCiphertext":{"anyOf":[{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","description":"Optional client-encrypted provenance tag payload ciphertext","type":"string"},{"type":"null"}]},"tagPayloadUpdatedAt":{"anyOf":[{"format":"date-time","description":"ISO timestamp for the last provenance tag payload update","type":"string"},{"type":"null"}]},"tagEligibility":{"anyOf":[{"type":"string","enum":["eligible"]},{"type":"string","enum":["received_before_tagging"]}]},"tagEditable":{"description":"True when this receive source is post-launch and may be tagged by the current account","type":"boolean"},"systemTags":{"description":"Server-derived tags based on public onchain facts","type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["pool-receive"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["pool_receive"]},"evidence":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"},"receiveFromAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"entrypointAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolTransferOrLogIndex":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]}},"required":["chainId","txHash","transferOrLogIndex","receiveFromAddress","poolAddress","entrypointAddress","poolTransferOrLogIndex"]}},"required":["type","text","explanationKey","evidence"]},{"type":"object","properties":{"type":{"type":"string","enum":["dapp-used"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["dapp_used"]},"evidence":{"type":"object","properties":{"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"origins":{"type":"array","items":{"type":"object","properties":{"origin":{"type":"string"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastUsedAt":{"format":"date-time","type":"string"}},"required":["origin","displayName","iconUrl","lastUsedAt"]}},"matchedOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestUsedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["address","origins","matchedOrigin","latestUsedAt"]}},"required":["type","text","explanationKey","evidence"]}]}}},"required":["id","kind","origin","address","tagPayloadCiphertext","tagPayloadUpdatedAt","tagEligibility","tagEditable","systemTags"]}},"systemLabels":{"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","enum":["pool_receive"]},{"type":"string","enum":["dapp_used"]}]},"text":{"description":"Short server-derived label text for display","type":"string"},"iconUrl":{"anyOf":[{"description":"Optional safe proxied icon URL for system labels with app metadata","type":"string"},{"type":"null"}]}},"required":["key","text"]}},"hasNoTag":{"description":"True when represented provenance includes at least one untagged source.","type":"boolean"},"hasOlderFunds":{"description":"True when represented provenance includes older/pre-tagging funds.","type":"boolean"},"hasUnknown":{"description":"True when represented provenance includes unresolved provenance.","type":"boolean"}},"required":["encryptedTagSources","systemLabels","hasNoTag","hasOlderFunds","hasUnknown"]}},"fees":{"type":"object","properties":{"network":{"description":"Gas/relay fee in wei (gas cost only, excludes dust)","type":"string"},"dust":{"description":"Residual balance below the dust threshold swept into the relayer payment. Not a gas fee — included in total but not in network.","type":"string"},"service":{"description":"Protocol fees in wei (vetting + cloaked, or swap protocol fee)","type":"string"},"networkUsdAmount":{"description":"USD value of the network fee, or null when USD pricing is unavailable","anyOf":[{"type":"number"},{"type":"null"}]},"totalUsdAmount":{"description":"USD value of the total fee, or null when USD pricing is unavailable","anyOf":[{"type":"number"},{"type":"null"}]},"vetting":{"description":"On-chain vetting fee in wei (pool deposits only)","type":"string"},"deposit":{"description":"Cloaked deposit fee in wei (pool deposits only)","type":"string"},"total":{"description":"Total fees in wei (network + dust + service)","type":"string"},"waived":{"description":"True when fees are waived (e.g. Cloakie holder on swaps)","type":"boolean"}},"required":["network","service","total"]}},"required":["intents","delegations","quoteId","expiresAt","signature","poolAddress","depositIndex","grossAmount","feeAmount","feeBps","netPoolValue","cloakedFeeBps","cloakedFlatFee","cloakieFeeMode","fees"]},{"title":"OffRampQuoteResponse","type":"object","properties":{"quoteId":{"type":"string"},"signature":{"type":"string"},"route":{"anyOf":[{"type":"string","enum":["direct"]},{"type":"string","enum":["swap"]},{"type":"string","enum":["bridge"]}]},"routeDisplay":{"type":"object","properties":{"steps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"}},"required":["id","label"]}},"description":{"type":"string"}},"required":["steps","description"]},"fees":{"type":"object","properties":{"network":{"type":"string"},"service":{"type":"string"},"total":{"type":"string"},"waived":{"type":"boolean"}},"required":["network","service","total"]},"expiresAt":{"type":"string"},"sourceAmount":{"type":"string"},"escrowAmount":{"type":"string"},"feeTokenAddress":{"type":"string"},"feeChainId":{"type":"number"},"feeDecimals":{"type":"number"},"feeTokenSymbol":{"type":"string"},"conversionRate":{"anyOf":[{"type":"number"},{"type":"null"}]},"estimatedFiatAmount":{"type":"string"},"marketContext":{"anyOf":[{"type":"object","properties":{"available":{"type":"boolean","enum":[true]},"platform":{"type":"string"},"currency":{"type":"string","enum":["USD"]},"liquidity":{"type":"object","properties":{"totalUsd":{"anyOf":[{"type":"number"},{"type":"null"}]},"coverageRatio":{"anyOf":[{"type":"number"},{"type":"null"}]},"label":{"anyOf":[{"type":"string","enum":["strong"]},{"type":"string","enum":["ok"]},{"type":"string","enum":["thin"]},{"type":"string","enum":["unknown"]}]}},"required":["totalUsd","coverageRatio","label"]},"fillTime":{"type":"object","properties":{"medianSeconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"p75Seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"label":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["medianSeconds","p75Seconds","label"]},"confidence":{"type":"object","properties":{"score":{"type":"number"},"label":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["low"]},{"type":"string","enum":["unknown"]}]},"reasons":{"type":"array","items":{"type":"string"}}},"required":["score","label","reasons"]},"message":{"type":"string"},"updatedAt":{"type":"string"}},"required":["available","platform","currency","liquidity","fillTime","confidence","message","updatedAt"]},{"type":"null"}]},"intents":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"eoa":{"type":"string"},"executionData":{"type":"string"},"nonce":{"type":"string"},"derivationNonce":{"type":"string"},"payer":{"type":"string"},"paymentToken":{"type":"string"},"paymentMaxAmount":{"type":"string"},"combinedGas":{"type":"string"},"encodedPreCalls":{"type":"array","items":{"type":"string"}},"encodedFundTransfers":{"type":"array","items":{"type":"string"}},"settler":{"type":"string"},"expiry":{"type":"string"},"isMultichain":{"type":"boolean"},"funder":{"type":"string"},"funderSignature":{"type":"string"},"settlerContext":{"type":"string"},"paymentAmount":{"type":"string"},"paymentRecipient":{"type":"string"},"paymentSignature":{"type":"string"},"supportedAccountImplementation":{"type":"string"},"domain":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"chainId":{"type":"number"},"verifyingContract":{"type":"string"}},"required":["name","version","chainId","verifyingContract"]},"types":{"description":"EIP-712 type definitions"},"primaryType":{"type":"string","enum":["Intent"]}},"required":["chainId","eoa","executionData","nonce","derivationNonce","payer","paymentToken","paymentMaxAmount","combinedGas","encodedPreCalls","encodedFundTransfers","settler","expiry","isMultichain","funder","funderSignature","settlerContext","paymentAmount","paymentRecipient","paymentSignature","supportedAccountImplementation","domain","types","primaryType"]}},"delegations":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"address":{"type":"string"},"contractAddress":{"type":"string"},"derivationNonce":{"type":"number"},"authorizationNonce":{"type":"number"}},"required":["chainId","address","contractAddress","derivationNonce","authorizationNonce"]}},"selectedFundingSources":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"token":{"type":"string"},"address":{"type":"string"},"amount":{"description":"Raw selected amount in smallest unit","type":"string"},"idCount":{"description":"Number of spendable output IDs represented by this selected funding source","type":"number"},"addressSummary":{"type":"object","properties":{"receiveCount":{"description":"Action-aware inbound receive count. Trusted Cloaked actions that emit multiple transfer logs are counted once.","type":"number"},"rawReceiveCount":{"description":"Literal distinct inbound transfer/log count before trusted-action collapsing.","type":"number"},"trustedReceiveActionCount":{"description":"Number of Cloaked-managed receive actions collapsed into receiveCount.","type":"number"},"trustedReceiveActionTypes":{"type":"array","items":{"type":"string"}},"assetCount":{"description":"Distinct chain-token assets seen for this address.","type":"number"},"chainCount":{"description":"Distinct networks seen for this address.","type":"number"}},"required":["receiveCount","rawReceiveCount","trustedReceiveActionCount","trustedReceiveActionTypes","assetCount","chainCount"]},"provenance":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["resolved"]},{"type":"string","enum":["unavailable"]}]},"sourceLabelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"description":"Number of pre-launch checkpoint provenance markers represented by this balance.","type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}},"displayContext":{"type":"object","properties":{"reason":{"anyOf":[{"type":"string","enum":["fresh_receive"]},{"type":"string","enum":["cloaked_action_output"]},{"type":"string","enum":["mixed_current_outputs"]},{"type":"string","enum":["carried_source"]},{"type":"string","enum":["older_funds"]},{"type":"string","enum":["unavailable"]}]},"currentOutputCount":{"minimum":0,"type":"integer"},"sourceCount":{"minimum":0,"type":"integer"},"actionTypes":{"type":"array","items":{"type":"string"}}},"required":["reason","currentOutputCount","sourceCount","actionTypes"]},"funding":{"type":"object","properties":{"labelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}}},"required":["labelGroupId","olderFundsCount","unresolvedReasons"]},"association":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["clean"]},{"type":"string","enum":["linked"]},{"type":"string","enum":["unknown"]}]},"labelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}},"ignoredUnsolicitedCount":{"minimum":0,"type":"integer"},"summary":{"type":"object","properties":{"sourceCount":{"minimum":0,"type":"integer"},"poolReceiveCount":{"minimum":0,"type":"integer"},"userTaggedSourceCount":{"minimum":0,"type":"integer"},"untaggedSourceCount":{"minimum":0,"type":"integer"},"olderFundsCount":{"minimum":0,"type":"integer"},"unknownCount":{"minimum":0,"type":"integer"}},"required":["sourceCount","poolReceiveCount","userTaggedSourceCount","untaggedSourceCount","olderFundsCount","unknownCount"]}},"required":["status","labelGroupId","olderFundsCount","unresolvedReasons","ignoredUnsolicitedCount","summary"]},"display":{"type":"object","properties":{"badgeKind":{"anyOf":[{"type":"string","enum":["incognito_clean"]},{"type":"string","enum":["tagged"]},{"type":"string","enum":["mixed"]},{"type":"string","enum":["older_funds"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["untagged"]}]},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"fundingLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"associationLabel":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["badgeKind","label","fundingLabel","associationLabel"]},"editableSource":{"description":"The single directly editable receive source for this item, when one exists.","anyOf":[{"type":"object","properties":{"id":{"description":"Stable provenance source key","type":"string"},"kind":{"type":"string","enum":["receive"]},"origin":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"}},"required":["chainId","txHash","transferOrLogIndex"]},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","description":"Owned address where this receive source originally landed","type":"string"},"tagPayloadCiphertext":{"anyOf":[{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","description":"Optional client-encrypted provenance tag payload ciphertext","type":"string"},{"type":"null"}]},"tagPayloadUpdatedAt":{"anyOf":[{"format":"date-time","description":"ISO timestamp for the last provenance tag payload update","type":"string"},{"type":"null"}]},"tagEligibility":{"anyOf":[{"type":"string","enum":["eligible"]},{"type":"string","enum":["received_before_tagging"]}]},"tagEditable":{"description":"True when this receive source is post-launch and may be tagged by the current account","type":"boolean"},"systemTags":{"description":"Server-derived tags based on public onchain facts","type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["pool-receive"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["pool_receive"]},"evidence":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"},"receiveFromAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"entrypointAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolTransferOrLogIndex":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]}},"required":["chainId","txHash","transferOrLogIndex","receiveFromAddress","poolAddress","entrypointAddress","poolTransferOrLogIndex"]}},"required":["type","text","explanationKey","evidence"]},{"type":"object","properties":{"type":{"type":"string","enum":["dapp-used"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["dapp_used"]},"evidence":{"type":"object","properties":{"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"origins":{"type":"array","items":{"type":"object","properties":{"origin":{"type":"string"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastUsedAt":{"format":"date-time","type":"string"}},"required":["origin","displayName","iconUrl","lastUsedAt"]}},"matchedOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestUsedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["address","origins","matchedOrigin","latestUsedAt"]}},"required":["type","text","explanationKey","evidence"]}]}}},"required":["id","kind","origin","address","tagPayloadCiphertext","tagPayloadUpdatedAt","tagEligibility","tagEditable","systemTags"]},{"type":"null"}]}},"required":["status","sourceLabelGroupId","olderFundsCount","unresolvedReasons","displayContext","funding","association","display","editableSource"]}},"required":["chainId","token","address","amount","idCount","addressSummary","provenance"]}},"provenanceLabelGroups":{"type":"object","additionalProperties":{"type":"object","properties":{"encryptedTagSources":{"description":"Only receive sources with encrypted user tag payloads needed for client-side label display.","type":"array","items":{"type":"object","properties":{"id":{"description":"Stable provenance source key","type":"string"},"kind":{"type":"string","enum":["receive"]},"origin":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"}},"required":["chainId","txHash","transferOrLogIndex"]},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","description":"Owned address where this receive source originally landed","type":"string"},"tagPayloadCiphertext":{"anyOf":[{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","description":"Optional client-encrypted provenance tag payload ciphertext","type":"string"},{"type":"null"}]},"tagPayloadUpdatedAt":{"anyOf":[{"format":"date-time","description":"ISO timestamp for the last provenance tag payload update","type":"string"},{"type":"null"}]},"tagEligibility":{"anyOf":[{"type":"string","enum":["eligible"]},{"type":"string","enum":["received_before_tagging"]}]},"tagEditable":{"description":"True when this receive source is post-launch and may be tagged by the current account","type":"boolean"},"systemTags":{"description":"Server-derived tags based on public onchain facts","type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["pool-receive"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["pool_receive"]},"evidence":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"},"receiveFromAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"entrypointAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolTransferOrLogIndex":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]}},"required":["chainId","txHash","transferOrLogIndex","receiveFromAddress","poolAddress","entrypointAddress","poolTransferOrLogIndex"]}},"required":["type","text","explanationKey","evidence"]},{"type":"object","properties":{"type":{"type":"string","enum":["dapp-used"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["dapp_used"]},"evidence":{"type":"object","properties":{"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"origins":{"type":"array","items":{"type":"object","properties":{"origin":{"type":"string"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastUsedAt":{"format":"date-time","type":"string"}},"required":["origin","displayName","iconUrl","lastUsedAt"]}},"matchedOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestUsedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["address","origins","matchedOrigin","latestUsedAt"]}},"required":["type","text","explanationKey","evidence"]}]}}},"required":["id","kind","origin","address","tagPayloadCiphertext","tagPayloadUpdatedAt","tagEligibility","tagEditable","systemTags"]}},"systemLabels":{"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","enum":["pool_receive"]},{"type":"string","enum":["dapp_used"]}]},"text":{"description":"Short server-derived label text for display","type":"string"},"iconUrl":{"anyOf":[{"description":"Optional safe proxied icon URL for system labels with app metadata","type":"string"},{"type":"null"}]}},"required":["key","text"]}},"hasNoTag":{"description":"True when represented provenance includes at least one untagged source.","type":"boolean"},"hasOlderFunds":{"description":"True when represented provenance includes older/pre-tagging funds.","type":"boolean"},"hasUnknown":{"description":"True when represented provenance includes unresolved provenance.","type":"boolean"}},"required":["encryptedTagSources","systemLabels","hasNoTag","hasOlderFunds","hasUnknown"]}}},"required":["quoteId","signature","route","fees","expiresAt","sourceAmount","escrowAmount","feeTokenAddress","feeChainId","feeDecimals","feeTokenSymbol","conversionRate","estimatedFiatAmount"]},{"title":"OffRampCancelQuoteResponse","type":"object","properties":{"intents":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"eoa":{"type":"string"},"executionData":{"type":"string"},"nonce":{"type":"string"},"derivationNonce":{"type":"string"},"payer":{"type":"string"},"paymentToken":{"type":"string"},"paymentMaxAmount":{"type":"string"},"combinedGas":{"type":"string"},"encodedPreCalls":{"type":"array","items":{"type":"string"}},"encodedFundTransfers":{"type":"array","items":{"type":"string"}},"settler":{"type":"string"},"expiry":{"type":"string"},"isMultichain":{"type":"boolean"},"funder":{"type":"string"},"funderSignature":{"type":"string"},"settlerContext":{"type":"string"},"paymentAmount":{"type":"string"},"paymentRecipient":{"type":"string"},"paymentSignature":{"type":"string"},"supportedAccountImplementation":{"type":"string"},"domain":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"chainId":{"type":"number"},"verifyingContract":{"type":"string"}},"required":["name","version","chainId","verifyingContract"]},"types":{"description":"EIP-712 type definitions"},"primaryType":{"type":"string","enum":["Intent"]}},"required":["chainId","eoa","executionData","nonce","derivationNonce","payer","paymentToken","paymentMaxAmount","combinedGas","encodedPreCalls","encodedFundTransfers","settler","expiry","isMultichain","funder","funderSignature","settlerContext","paymentAmount","paymentRecipient","paymentSignature","supportedAccountImplementation","domain","types","primaryType"]}},"delegations":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"address":{"type":"string"},"contractAddress":{"type":"string"},"derivationNonce":{"type":"number"},"authorizationNonce":{"type":"number"}},"required":["chainId","address","contractAddress","derivationNonce","authorizationNonce"]}},"quoteId":{"type":"string"},"expiresAt":{"type":"string"},"signature":{"type":"string"},"fees":{"type":"object","properties":{"network":{"description":"Gas/relay fee in wei (gas cost only, excludes dust)","type":"string"},"dust":{"description":"Residual balance below the dust threshold swept into the relayer payment. Not a gas fee — included in total but not in network.","type":"string"},"service":{"description":"Protocol fees in wei (vetting + cloaked, or swap protocol fee)","type":"string"},"networkUsdAmount":{"description":"USD value of the network fee, or null when USD pricing is unavailable","anyOf":[{"type":"number"},{"type":"null"}]},"totalUsdAmount":{"description":"USD value of the total fee, or null when USD pricing is unavailable","anyOf":[{"type":"number"},{"type":"null"}]},"vetting":{"description":"On-chain vetting fee in wei (pool deposits only)","type":"string"},"deposit":{"description":"Cloaked deposit fee in wei (pool deposits only)","type":"string"},"total":{"description":"Total fees in wei (network + dust + service)","type":"string"},"waived":{"description":"True when fees are waived (e.g. Cloakie holder on swaps)","type":"boolean"}},"required":["network","service","total"]},"remainingAmount":{"description":"Withdrawable amount (remainingDeposits)","type":"string"}},"required":["intents","delegations","quoteId","expiresAt","signature","fees","remainingAmount"]},{"title":"BatchSendQuoteResponse","type":"object","properties":{"intents":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"eoa":{"type":"string"},"executionData":{"type":"string"},"nonce":{"type":"string"},"derivationNonce":{"type":"string"},"payer":{"type":"string"},"paymentToken":{"type":"string"},"paymentMaxAmount":{"type":"string"},"combinedGas":{"type":"string"},"encodedPreCalls":{"type":"array","items":{"type":"string"}},"encodedFundTransfers":{"type":"array","items":{"type":"string"}},"settler":{"type":"string"},"expiry":{"type":"string"},"isMultichain":{"type":"boolean"},"funder":{"type":"string"},"funderSignature":{"type":"string"},"settlerContext":{"type":"string"},"paymentAmount":{"type":"string"},"paymentRecipient":{"type":"string"},"paymentSignature":{"type":"string"},"supportedAccountImplementation":{"type":"string"},"domain":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"chainId":{"type":"number"},"verifyingContract":{"type":"string"}},"required":["name","version","chainId","verifyingContract"]},"types":{"description":"EIP-712 type definitions"},"primaryType":{"type":"string","enum":["Intent"]}},"required":["chainId","eoa","executionData","nonce","derivationNonce","payer","paymentToken","paymentMaxAmount","combinedGas","encodedPreCalls","encodedFundTransfers","settler","expiry","isMultichain","funder","funderSignature","settlerContext","paymentAmount","paymentRecipient","paymentSignature","supportedAccountImplementation","domain","types","primaryType"]}},"delegations":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"address":{"type":"string"},"contractAddress":{"type":"string"},"derivationNonce":{"type":"number"},"authorizationNonce":{"type":"number"}},"required":["chainId","address","contractAddress","derivationNonce","authorizationNonce"]}},"quoteId":{"type":"string"},"expiresAt":{"type":"string"},"signature":{"type":"string"},"resolvedDestination":{"type":"string"},"destinationAvatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"selfSend":{"type":"boolean"},"sourceAssets":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"token":{"type":"string"},"decimals":{"type":"number"},"symbol":{"type":"string"},"amount":{"type":"string"},"selectedFundingSources":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"token":{"type":"string"},"address":{"type":"string"},"amount":{"description":"Raw selected amount in smallest unit","type":"string"},"idCount":{"description":"Number of spendable output IDs represented by this selected funding source","type":"number"},"addressSummary":{"type":"object","properties":{"receiveCount":{"description":"Action-aware inbound receive count. Trusted Cloaked actions that emit multiple transfer logs are counted once.","type":"number"},"rawReceiveCount":{"description":"Literal distinct inbound transfer/log count before trusted-action collapsing.","type":"number"},"trustedReceiveActionCount":{"description":"Number of Cloaked-managed receive actions collapsed into receiveCount.","type":"number"},"trustedReceiveActionTypes":{"type":"array","items":{"type":"string"}},"assetCount":{"description":"Distinct chain-token assets seen for this address.","type":"number"},"chainCount":{"description":"Distinct networks seen for this address.","type":"number"}},"required":["receiveCount","rawReceiveCount","trustedReceiveActionCount","trustedReceiveActionTypes","assetCount","chainCount"]},"provenance":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["resolved"]},{"type":"string","enum":["unavailable"]}]},"sourceLabelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"description":"Number of pre-launch checkpoint provenance markers represented by this balance.","type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}},"displayContext":{"type":"object","properties":{"reason":{"anyOf":[{"type":"string","enum":["fresh_receive"]},{"type":"string","enum":["cloaked_action_output"]},{"type":"string","enum":["mixed_current_outputs"]},{"type":"string","enum":["carried_source"]},{"type":"string","enum":["older_funds"]},{"type":"string","enum":["unavailable"]}]},"currentOutputCount":{"minimum":0,"type":"integer"},"sourceCount":{"minimum":0,"type":"integer"},"actionTypes":{"type":"array","items":{"type":"string"}}},"required":["reason","currentOutputCount","sourceCount","actionTypes"]},"funding":{"type":"object","properties":{"labelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}}},"required":["labelGroupId","olderFundsCount","unresolvedReasons"]},"association":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["clean"]},{"type":"string","enum":["linked"]},{"type":"string","enum":["unknown"]}]},"labelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}},"ignoredUnsolicitedCount":{"minimum":0,"type":"integer"},"summary":{"type":"object","properties":{"sourceCount":{"minimum":0,"type":"integer"},"poolReceiveCount":{"minimum":0,"type":"integer"},"userTaggedSourceCount":{"minimum":0,"type":"integer"},"untaggedSourceCount":{"minimum":0,"type":"integer"},"olderFundsCount":{"minimum":0,"type":"integer"},"unknownCount":{"minimum":0,"type":"integer"}},"required":["sourceCount","poolReceiveCount","userTaggedSourceCount","untaggedSourceCount","olderFundsCount","unknownCount"]}},"required":["status","labelGroupId","olderFundsCount","unresolvedReasons","ignoredUnsolicitedCount","summary"]},"display":{"type":"object","properties":{"badgeKind":{"anyOf":[{"type":"string","enum":["incognito_clean"]},{"type":"string","enum":["tagged"]},{"type":"string","enum":["mixed"]},{"type":"string","enum":["older_funds"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["untagged"]}]},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"fundingLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"associationLabel":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["badgeKind","label","fundingLabel","associationLabel"]},"editableSource":{"description":"The single directly editable receive source for this item, when one exists.","anyOf":[{"type":"object","properties":{"id":{"description":"Stable provenance source key","type":"string"},"kind":{"type":"string","enum":["receive"]},"origin":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"}},"required":["chainId","txHash","transferOrLogIndex"]},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","description":"Owned address where this receive source originally landed","type":"string"},"tagPayloadCiphertext":{"anyOf":[{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","description":"Optional client-encrypted provenance tag payload ciphertext","type":"string"},{"type":"null"}]},"tagPayloadUpdatedAt":{"anyOf":[{"format":"date-time","description":"ISO timestamp for the last provenance tag payload update","type":"string"},{"type":"null"}]},"tagEligibility":{"anyOf":[{"type":"string","enum":["eligible"]},{"type":"string","enum":["received_before_tagging"]}]},"tagEditable":{"description":"True when this receive source is post-launch and may be tagged by the current account","type":"boolean"},"systemTags":{"description":"Server-derived tags based on public onchain facts","type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["pool-receive"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["pool_receive"]},"evidence":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"},"receiveFromAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"entrypointAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolTransferOrLogIndex":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]}},"required":["chainId","txHash","transferOrLogIndex","receiveFromAddress","poolAddress","entrypointAddress","poolTransferOrLogIndex"]}},"required":["type","text","explanationKey","evidence"]},{"type":"object","properties":{"type":{"type":"string","enum":["dapp-used"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["dapp_used"]},"evidence":{"type":"object","properties":{"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"origins":{"type":"array","items":{"type":"object","properties":{"origin":{"type":"string"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastUsedAt":{"format":"date-time","type":"string"}},"required":["origin","displayName","iconUrl","lastUsedAt"]}},"matchedOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestUsedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["address","origins","matchedOrigin","latestUsedAt"]}},"required":["type","text","explanationKey","evidence"]}]}}},"required":["id","kind","origin","address","tagPayloadCiphertext","tagPayloadUpdatedAt","tagEligibility","tagEditable","systemTags"]},{"type":"null"}]}},"required":["status","sourceLabelGroupId","olderFundsCount","unresolvedReasons","displayContext","funding","association","display","editableSource"]}},"required":["chainId","token","address","amount","idCount","addressSummary","provenance"]}},"provenanceLabelGroups":{"type":"object","additionalProperties":{"type":"object","properties":{"encryptedTagSources":{"description":"Only receive sources with encrypted user tag payloads needed for client-side label display.","type":"array","items":{"type":"object","properties":{"id":{"description":"Stable provenance source key","type":"string"},"kind":{"type":"string","enum":["receive"]},"origin":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"}},"required":["chainId","txHash","transferOrLogIndex"]},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","description":"Owned address where this receive source originally landed","type":"string"},"tagPayloadCiphertext":{"anyOf":[{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","description":"Optional client-encrypted provenance tag payload ciphertext","type":"string"},{"type":"null"}]},"tagPayloadUpdatedAt":{"anyOf":[{"format":"date-time","description":"ISO timestamp for the last provenance tag payload update","type":"string"},{"type":"null"}]},"tagEligibility":{"anyOf":[{"type":"string","enum":["eligible"]},{"type":"string","enum":["received_before_tagging"]}]},"tagEditable":{"description":"True when this receive source is post-launch and may be tagged by the current account","type":"boolean"},"systemTags":{"description":"Server-derived tags based on public onchain facts","type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["pool-receive"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["pool_receive"]},"evidence":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"},"receiveFromAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"entrypointAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolTransferOrLogIndex":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]}},"required":["chainId","txHash","transferOrLogIndex","receiveFromAddress","poolAddress","entrypointAddress","poolTransferOrLogIndex"]}},"required":["type","text","explanationKey","evidence"]},{"type":"object","properties":{"type":{"type":"string","enum":["dapp-used"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["dapp_used"]},"evidence":{"type":"object","properties":{"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"origins":{"type":"array","items":{"type":"object","properties":{"origin":{"type":"string"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastUsedAt":{"format":"date-time","type":"string"}},"required":["origin","displayName","iconUrl","lastUsedAt"]}},"matchedOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestUsedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["address","origins","matchedOrigin","latestUsedAt"]}},"required":["type","text","explanationKey","evidence"]}]}}},"required":["id","kind","origin","address","tagPayloadCiphertext","tagPayloadUpdatedAt","tagEligibility","tagEditable","systemTags"]}},"systemLabels":{"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","enum":["pool_receive"]},{"type":"string","enum":["dapp_used"]}]},"text":{"description":"Short server-derived label text for display","type":"string"},"iconUrl":{"anyOf":[{"description":"Optional safe proxied icon URL for system labels with app metadata","type":"string"},{"type":"null"}]}},"required":["key","text"]}},"hasNoTag":{"description":"True when represented provenance includes at least one untagged source.","type":"boolean"},"hasOlderFunds":{"description":"True when represented provenance includes older/pre-tagging funds.","type":"boolean"},"hasUnknown":{"description":"True when represented provenance includes unresolved provenance.","type":"boolean"}},"required":["encryptedTagSources","systemLabels","hasNoTag","hasOlderFunds","hasUnknown"]}},"fees":{"type":"object","properties":{"network":{"description":"Gas/relay fee in wei (gas cost only, excludes dust)","type":"string"},"dust":{"description":"Residual balance below the dust threshold swept into the relayer payment. Not a gas fee — included in total but not in network.","type":"string"},"service":{"description":"Protocol fees in wei (vetting + cloaked, or swap protocol fee)","type":"string"},"networkUsdAmount":{"description":"USD value of the network fee, or null when USD pricing is unavailable","anyOf":[{"type":"number"},{"type":"null"}]},"totalUsdAmount":{"description":"USD value of the total fee, or null when USD pricing is unavailable","anyOf":[{"type":"number"},{"type":"null"}]},"vetting":{"description":"On-chain vetting fee in wei (pool deposits only)","type":"string"},"deposit":{"description":"Cloaked deposit fee in wei (pool deposits only)","type":"string"},"total":{"description":"Total fees in wei (network + dust + service)","type":"string"},"waived":{"description":"True when fees are waived (e.g. Cloakie holder on swaps)","type":"boolean"}},"required":["network","service","total"]}},"required":["chainId","token","decimals","symbol","amount","fees"]}},"feeTotals":{"type":"object","properties":{"totalUsdAmount":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["totalUsdAmount"]}},"required":["intents","delegations","quoteId","expiresAt","signature","resolvedDestination","destinationAvatarUrl","selfSend","sourceAssets","feeTotals"]},{"title":"SendQuoteResponse","type":"object","properties":{"intents":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"eoa":{"type":"string"},"executionData":{"type":"string"},"nonce":{"type":"string"},"derivationNonce":{"type":"string"},"payer":{"type":"string"},"paymentToken":{"type":"string"},"paymentMaxAmount":{"type":"string"},"combinedGas":{"type":"string"},"encodedPreCalls":{"type":"array","items":{"type":"string"}},"encodedFundTransfers":{"type":"array","items":{"type":"string"}},"settler":{"type":"string"},"expiry":{"type":"string"},"isMultichain":{"type":"boolean"},"funder":{"type":"string"},"funderSignature":{"type":"string"},"settlerContext":{"type":"string"},"paymentAmount":{"type":"string"},"paymentRecipient":{"type":"string"},"paymentSignature":{"type":"string"},"supportedAccountImplementation":{"type":"string"},"domain":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"chainId":{"type":"number"},"verifyingContract":{"type":"string"}},"required":["name","version","chainId","verifyingContract"]},"types":{"description":"EIP-712 type definitions"},"primaryType":{"type":"string","enum":["Intent"]}},"required":["chainId","eoa","executionData","nonce","derivationNonce","payer","paymentToken","paymentMaxAmount","combinedGas","encodedPreCalls","encodedFundTransfers","settler","expiry","isMultichain","funder","funderSignature","settlerContext","paymentAmount","paymentRecipient","paymentSignature","supportedAccountImplementation","domain","types","primaryType"]}},"delegations":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"address":{"type":"string"},"contractAddress":{"type":"string"},"derivationNonce":{"type":"number"},"authorizationNonce":{"type":"number"}},"required":["chainId","address","contractAddress","derivationNonce","authorizationNonce"]}},"quoteId":{"type":"string"},"expiresAt":{"type":"string"},"signature":{"type":"string"},"resolvedDestination":{"type":"string"},"destinationAvatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceAmount":{"description":"Source amount selected for the send, in smallest units","type":"string"},"selfSend":{"type":"boolean"},"selectedFundingSources":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"token":{"type":"string"},"address":{"type":"string"},"amount":{"description":"Raw selected amount in smallest unit","type":"string"},"idCount":{"description":"Number of spendable output IDs represented by this selected funding source","type":"number"},"addressSummary":{"type":"object","properties":{"receiveCount":{"description":"Action-aware inbound receive count. Trusted Cloaked actions that emit multiple transfer logs are counted once.","type":"number"},"rawReceiveCount":{"description":"Literal distinct inbound transfer/log count before trusted-action collapsing.","type":"number"},"trustedReceiveActionCount":{"description":"Number of Cloaked-managed receive actions collapsed into receiveCount.","type":"number"},"trustedReceiveActionTypes":{"type":"array","items":{"type":"string"}},"assetCount":{"description":"Distinct chain-token assets seen for this address.","type":"number"},"chainCount":{"description":"Distinct networks seen for this address.","type":"number"}},"required":["receiveCount","rawReceiveCount","trustedReceiveActionCount","trustedReceiveActionTypes","assetCount","chainCount"]},"provenance":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["resolved"]},{"type":"string","enum":["unavailable"]}]},"sourceLabelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"description":"Number of pre-launch checkpoint provenance markers represented by this balance.","type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}},"displayContext":{"type":"object","properties":{"reason":{"anyOf":[{"type":"string","enum":["fresh_receive"]},{"type":"string","enum":["cloaked_action_output"]},{"type":"string","enum":["mixed_current_outputs"]},{"type":"string","enum":["carried_source"]},{"type":"string","enum":["older_funds"]},{"type":"string","enum":["unavailable"]}]},"currentOutputCount":{"minimum":0,"type":"integer"},"sourceCount":{"minimum":0,"type":"integer"},"actionTypes":{"type":"array","items":{"type":"string"}}},"required":["reason","currentOutputCount","sourceCount","actionTypes"]},"funding":{"type":"object","properties":{"labelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}}},"required":["labelGroupId","olderFundsCount","unresolvedReasons"]},"association":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["clean"]},{"type":"string","enum":["linked"]},{"type":"string","enum":["unknown"]}]},"labelGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"olderFundsCount":{"minimum":0,"type":"integer"},"unresolvedReasons":{"type":"array","items":{"type":"string"}},"ignoredUnsolicitedCount":{"minimum":0,"type":"integer"},"summary":{"type":"object","properties":{"sourceCount":{"minimum":0,"type":"integer"},"poolReceiveCount":{"minimum":0,"type":"integer"},"userTaggedSourceCount":{"minimum":0,"type":"integer"},"untaggedSourceCount":{"minimum":0,"type":"integer"},"olderFundsCount":{"minimum":0,"type":"integer"},"unknownCount":{"minimum":0,"type":"integer"}},"required":["sourceCount","poolReceiveCount","userTaggedSourceCount","untaggedSourceCount","olderFundsCount","unknownCount"]}},"required":["status","labelGroupId","olderFundsCount","unresolvedReasons","ignoredUnsolicitedCount","summary"]},"display":{"type":"object","properties":{"badgeKind":{"anyOf":[{"type":"string","enum":["incognito_clean"]},{"type":"string","enum":["tagged"]},{"type":"string","enum":["mixed"]},{"type":"string","enum":["older_funds"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["untagged"]}]},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"fundingLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"associationLabel":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["badgeKind","label","fundingLabel","associationLabel"]},"editableSource":{"description":"The single directly editable receive source for this item, when one exists.","anyOf":[{"type":"object","properties":{"id":{"description":"Stable provenance source key","type":"string"},"kind":{"type":"string","enum":["receive"]},"origin":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"}},"required":["chainId","txHash","transferOrLogIndex"]},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","description":"Owned address where this receive source originally landed","type":"string"},"tagPayloadCiphertext":{"anyOf":[{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","description":"Optional client-encrypted provenance tag payload ciphertext","type":"string"},{"type":"null"}]},"tagPayloadUpdatedAt":{"anyOf":[{"format":"date-time","description":"ISO timestamp for the last provenance tag payload update","type":"string"},{"type":"null"}]},"tagEligibility":{"anyOf":[{"type":"string","enum":["eligible"]},{"type":"string","enum":["received_before_tagging"]}]},"tagEditable":{"description":"True when this receive source is post-launch and may be tagged by the current account","type":"boolean"},"systemTags":{"description":"Server-derived tags based on public onchain facts","type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["pool-receive"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["pool_receive"]},"evidence":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"},"receiveFromAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"entrypointAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolTransferOrLogIndex":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]}},"required":["chainId","txHash","transferOrLogIndex","receiveFromAddress","poolAddress","entrypointAddress","poolTransferOrLogIndex"]}},"required":["type","text","explanationKey","evidence"]},{"type":"object","properties":{"type":{"type":"string","enum":["dapp-used"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["dapp_used"]},"evidence":{"type":"object","properties":{"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"origins":{"type":"array","items":{"type":"object","properties":{"origin":{"type":"string"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastUsedAt":{"format":"date-time","type":"string"}},"required":["origin","displayName","iconUrl","lastUsedAt"]}},"matchedOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestUsedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["address","origins","matchedOrigin","latestUsedAt"]}},"required":["type","text","explanationKey","evidence"]}]}}},"required":["id","kind","origin","address","tagPayloadCiphertext","tagPayloadUpdatedAt","tagEligibility","tagEditable","systemTags"]},{"type":"null"}]}},"required":["status","sourceLabelGroupId","olderFundsCount","unresolvedReasons","displayContext","funding","association","display","editableSource"]}},"required":["chainId","token","address","amount","idCount","addressSummary","provenance"]}},"provenanceLabelGroups":{"type":"object","additionalProperties":{"type":"object","properties":{"encryptedTagSources":{"description":"Only receive sources with encrypted user tag payloads needed for client-side label display.","type":"array","items":{"type":"object","properties":{"id":{"description":"Stable provenance source key","type":"string"},"kind":{"type":"string","enum":["receive"]},"origin":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"}},"required":["chainId","txHash","transferOrLogIndex"]},"address":{"pattern":"^0x[a-fA-F0-9]{40}$","description":"Owned address where this receive source originally landed","type":"string"},"tagPayloadCiphertext":{"anyOf":[{"maxLength":4096,"pattern":"^cloaked-aead:v1:provenance-tag\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$","description":"Optional client-encrypted provenance tag payload ciphertext","type":"string"},{"type":"null"}]},"tagPayloadUpdatedAt":{"anyOf":[{"format":"date-time","description":"ISO timestamp for the last provenance tag payload update","type":"string"},{"type":"null"}]},"tagEligibility":{"anyOf":[{"type":"string","enum":["eligible"]},{"type":"string","enum":["received_before_tagging"]}]},"tagEditable":{"description":"True when this receive source is post-launch and may be tagged by the current account","type":"boolean"},"systemTags":{"description":"Server-derived tags based on public onchain facts","type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["pool-receive"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["pool_receive"]},"evidence":{"type":"object","properties":{"chainId":{"type":"integer"},"txHash":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"transferOrLogIndex":{"minimum":0,"type":"integer"},"receiveFromAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"entrypointAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"poolTransferOrLogIndex":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]}},"required":["chainId","txHash","transferOrLogIndex","receiveFromAddress","poolAddress","entrypointAddress","poolTransferOrLogIndex"]}},"required":["type","text","explanationKey","evidence"]},{"type":"object","properties":{"type":{"type":"string","enum":["dapp-used"]},"text":{"description":"Short server-derived tag text for display","type":"string"},"explanationKey":{"type":"string","enum":["dapp_used"]},"evidence":{"type":"object","properties":{"address":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"origins":{"type":"array","items":{"type":"object","properties":{"origin":{"type":"string"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastUsedAt":{"format":"date-time","type":"string"}},"required":["origin","displayName","iconUrl","lastUsedAt"]}},"matchedOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestUsedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}},"required":["address","origins","matchedOrigin","latestUsedAt"]}},"required":["type","text","explanationKey","evidence"]}]}}},"required":["id","kind","origin","address","tagPayloadCiphertext","tagPayloadUpdatedAt","tagEligibility","tagEditable","systemTags"]}},"systemLabels":{"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","enum":["pool_receive"]},{"type":"string","enum":["dapp_used"]}]},"text":{"description":"Short server-derived label text for display","type":"string"},"iconUrl":{"anyOf":[{"description":"Optional safe proxied icon URL for system labels with app metadata","type":"string"},{"type":"null"}]}},"required":["key","text"]}},"hasNoTag":{"description":"True when represented provenance includes at least one untagged source.","type":"boolean"},"hasOlderFunds":{"description":"True when represented provenance includes older/pre-tagging funds.","type":"boolean"},"hasUnknown":{"description":"True when represented provenance includes unresolved provenance.","type":"boolean"}},"required":["encryptedTagSources","systemLabels","hasNoTag","hasOlderFunds","hasUnknown"]}},"fees":{"type":"object","properties":{"network":{"description":"Gas/relay fee in wei (gas cost only, excludes dust)","type":"string"},"dust":{"description":"Residual balance below the dust threshold swept into the relayer payment. Not a gas fee — included in total but not in network.","type":"string"},"service":{"description":"Protocol fees in wei (vetting + cloaked, or swap protocol fee)","type":"string"},"networkUsdAmount":{"description":"USD value of the network fee, or null when USD pricing is unavailable","anyOf":[{"type":"number"},{"type":"null"}]},"totalUsdAmount":{"description":"USD value of the total fee, or null when USD pricing is unavailable","anyOf":[{"type":"number"},{"type":"null"}]},"vetting":{"description":"On-chain vetting fee in wei (pool deposits only)","type":"string"},"deposit":{"description":"Cloaked deposit fee in wei (pool deposits only)","type":"string"},"total":{"description":"Total fees in wei (network + dust + service)","type":"string"},"waived":{"description":"True when fees are waived (e.g. Cloakie holder on swaps)","type":"boolean"}},"required":["network","service","total"]}},"required":["intents","delegations","quoteId","expiresAt","signature","resolvedDestination","destinationAvatarUrl","sourceAmount","selfSend","fees"]},{"title":"BoostDepositQuoteResponse","type":"object","properties":{"intents":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"eoa":{"type":"string"},"executionData":{"type":"string"},"nonce":{"type":"string"},"derivationNonce":{"type":"string"},"payer":{"type":"string"},"paymentToken":{"type":"string"},"paymentMaxAmount":{"type":"string"},"combinedGas":{"type":"string"},"encodedPreCalls":{"type":"array","items":{"type":"string"}},"encodedFundTransfers":{"type":"array","items":{"type":"string"}},"settler":{"type":"string"},"expiry":{"type":"string"},"isMultichain":{"type":"boolean"},"funder":{"type":"string"},"funderSignature":{"type":"string"},"settlerContext":{"type":"string"},"paymentAmount":{"type":"string"},"paymentRecipient":{"type":"string"},"paymentSignature":{"type":"string"},"supportedAccountImplementation":{"type":"string"},"domain":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"chainId":{"type":"number"},"verifyingContract":{"type":"string"}},"required":["name","version","chainId","verifyingContract"]},"types":{"description":"EIP-712 type definitions"},"primaryType":{"type":"string","enum":["Intent"]}},"required":["chainId","eoa","executionData","nonce","derivationNonce","payer","paymentToken","paymentMaxAmount","combinedGas","encodedPreCalls","encodedFundTransfers","settler","expiry","isMultichain","funder","funderSignature","settlerContext","paymentAmount","paymentRecipient","paymentSignature","supportedAccountImplementation","domain","types","primaryType"]}},"delegations":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"address":{"type":"string"},"contractAddress":{"type":"string"},"derivationNonce":{"type":"number"},"authorizationNonce":{"type":"number"}},"required":["chainId","address","contractAddress","derivationNonce","authorizationNonce"]}},"quoteId":{"type":"string"},"expiresAt":{"type":"string"},"signature":{"type":"string"},"poolAddress":{"type":"string"},"depositAmount":{"description":"Shielded deposit amount in the token smallest unit","type":"string"},"fees":{"type":"object","properties":{"network":{"description":"Gas/relay fee in wei (gas cost only, excludes dust)","type":"string"},"dust":{"description":"Residual balance below the dust threshold swept into the relayer payment. Not a gas fee — included in total but not in network.","type":"string"},"service":{"description":"Protocol fees in wei (vetting + cloaked, or swap protocol fee)","type":"string"},"networkUsdAmount":{"description":"USD value of the network fee, or null when USD pricing is unavailable","anyOf":[{"type":"number"},{"type":"null"}]},"totalUsdAmount":{"description":"USD value of the total fee, or null when USD pricing is unavailable","anyOf":[{"type":"number"},{"type":"null"}]},"vetting":{"description":"On-chain vetting fee in wei (pool deposits only)","type":"string"},"deposit":{"description":"Cloaked deposit fee in wei (pool deposits only)","type":"string"},"total":{"description":"Total fees in wei (network + dust + service)","type":"string"},"waived":{"description":"True when fees are waived (e.g. Cloakie holder on swaps)","type":"boolean"}},"required":["network","service","total"]}},"required":["intents","delegations","quoteId","expiresAt","signature","poolAddress","depositAmount","fees"]},{"title":"DappCallQuoteResponse","type":"object","properties":{"intents":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"eoa":{"type":"string"},"executionData":{"type":"string"},"nonce":{"type":"string"},"derivationNonce":{"type":"string"},"payer":{"type":"string"},"paymentToken":{"type":"string"},"paymentMaxAmount":{"type":"string"},"combinedGas":{"type":"string"},"encodedPreCalls":{"type":"array","items":{"type":"string"}},"encodedFundTransfers":{"type":"array","items":{"type":"string"}},"settler":{"type":"string"},"expiry":{"type":"string"},"isMultichain":{"type":"boolean"},"funder":{"type":"string"},"funderSignature":{"type":"string"},"settlerContext":{"type":"string"},"paymentAmount":{"type":"string"},"paymentRecipient":{"type":"string"},"paymentSignature":{"type":"string"},"supportedAccountImplementation":{"type":"string"},"domain":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"chainId":{"type":"number"},"verifyingContract":{"type":"string"}},"required":["name","version","chainId","verifyingContract"]},"types":{"description":"EIP-712 type definitions"},"primaryType":{"type":"string","enum":["Intent"]}},"required":["chainId","eoa","executionData","nonce","derivationNonce","payer","paymentToken","paymentMaxAmount","combinedGas","encodedPreCalls","encodedFundTransfers","settler","expiry","isMultichain","funder","funderSignature","settlerContext","paymentAmount","paymentRecipient","paymentSignature","supportedAccountImplementation","domain","types","primaryType"]}},"delegations":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"address":{"type":"string"},"contractAddress":{"type":"string"},"derivationNonce":{"type":"number"},"authorizationNonce":{"type":"number"}},"required":["chainId","address","contractAddress","derivationNonce","authorizationNonce"]}},"quoteId":{"type":"string"},"expiresAt":{"type":"string"},"signature":{"type":"string"},"fees":{"type":"object","properties":{"network":{"description":"Gas/relay fee in wei (gas cost only, excludes dust)","type":"string"},"dust":{"description":"Residual balance below the dust threshold swept into the relayer payment. Not a gas fee — included in total but not in network.","type":"string"},"service":{"description":"Protocol fees in wei (vetting + cloaked, or swap protocol fee)","type":"string"},"networkUsdAmount":{"description":"USD value of the network fee, or null when USD pricing is unavailable","anyOf":[{"type":"number"},{"type":"null"}]},"totalUsdAmount":{"description":"USD value of the total fee, or null when USD pricing is unavailable","anyOf":[{"type":"number"},{"type":"null"}]},"vetting":{"description":"On-chain vetting fee in wei (pool deposits only)","type":"string"},"deposit":{"description":"Cloaked deposit fee in wei (pool deposits only)","type":"string"},"total":{"description":"Total fees in wei (network + dust + service)","type":"string"},"waived":{"description":"True when fees are waived (e.g. Cloakie holder on swaps)","type":"boolean"}},"required":["network","service","total"]}},"required":["intents","delegations","quoteId","expiresAt","signature","fees"]},{"title":"GroupSendQuoteResponse","type":"object","properties":{"quoteId":{"type":"string"},"intents":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"eoa":{"type":"string"},"executionData":{"type":"string"},"nonce":{"type":"string"},"derivationNonce":{"type":"string"},"payer":{"type":"string"},"paymentToken":{"type":"string"},"paymentMaxAmount":{"type":"string"},"combinedGas":{"type":"string"},"encodedPreCalls":{"type":"array","items":{"type":"string"}},"encodedFundTransfers":{"type":"array","items":{"type":"string"}},"settler":{"type":"string"},"expiry":{"type":"string"},"isMultichain":{"type":"boolean"},"funder":{"type":"string"},"funderSignature":{"type":"string"},"settlerContext":{"type":"string"},"paymentAmount":{"type":"string"},"paymentRecipient":{"type":"string"},"paymentSignature":{"type":"string"},"supportedAccountImplementation":{"type":"string"},"domain":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"chainId":{"type":"number"},"verifyingContract":{"type":"string"}},"required":["name","version","chainId","verifyingContract"]},"types":{"description":"EIP-712 type definitions"},"primaryType":{"type":"string","enum":["Intent"]}},"required":["chainId","eoa","executionData","nonce","derivationNonce","payer","paymentToken","paymentMaxAmount","combinedGas","encodedPreCalls","encodedFundTransfers","settler","expiry","isMultichain","funder","funderSignature","settlerContext","paymentAmount","paymentRecipient","paymentSignature","supportedAccountImplementation","domain","types","primaryType"]}},"expiresAt":{"type":"string"}},"required":["quoteId","intents","expiresAt"]}]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}},{"status":"403","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Forbidden","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"409","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Conflict","type":"string"},"message":{"type":"string"},"code":{"example":"QUOTE_LOCK_CONFLICT","type":"string"}},"required":["error","message"]}},{"status":"429","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Too Many Requests","type":"string"},"message":{"example":"Rate limit exceeded. Maximum 30 requests per 1 minute.","type":"string"}},"required":["error","message"]}},{"status":"451","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unavailable","type":"string"},"message":{"type":"string"},"code":{"anyOf":[{"type":"string","enum":["GEO_RESTRICTED"]},{"type":"string","enum":["TOKENIZED_ASSET_GEO_RESTRICTED"]}]},"recoveryUrl":{"type":"string"}},"required":["error","message"]}},{"status":"502","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad Gateway","type":"string"},"message":{"type":"string"},"code":{"example":"SWAP_UNAVAILABLE","type":"string"}},"required":["error","message"]}},{"status":"503","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Service Unavailable","type":"string"},"message":{"type":"string"},"code":{"example":"SERVER_BUSY","description":"Machine-readable reason, such as SERVER_BUSY or POOL_STATE_REFRESHING.","type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### Submit transaction

<EndpointCard data={{"method":"POST","path":"/v1/accounts/{accountId}/submit","operationId":"submitTransaction","tags":["Transact"],"description":"Submit client-signed intents and delegations from a quote to relay the transaction on-chain. Validates signatures, checks price slippage, and submits via the server relayer so the user pays no gas directly.","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"},{"schema":{"type":"string"},"in":"header","name":"idempotency-key","required":false,"description":"Client-generated unique key (e.g. UUID). If the server has already processed a request with this key for the same account and body, it returns the cached response instead of re-executing. Keys expire after 24 hours."}],"requestBody":{"required":false,"schema":{"anyOf":[{"additionalProperties":false,"title":"PortoSubmitRequest","type":"object","properties":{"intents":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"eoa":{"type":"string"},"executionData":{"type":"string"},"nonce":{"type":"string"},"derivationNonce":{"type":"string"},"payer":{"type":"string"},"paymentToken":{"type":"string"},"paymentMaxAmount":{"type":"string"},"combinedGas":{"type":"string"},"encodedPreCalls":{"type":"array","items":{"type":"string"}},"encodedFundTransfers":{"type":"array","items":{"type":"string"}},"settler":{"type":"string"},"expiry":{"type":"string"},"isMultichain":{"type":"boolean"},"funder":{"type":"string"},"funderSignature":{"type":"string"},"settlerContext":{"type":"string"},"paymentAmount":{"type":"string"},"paymentRecipient":{"type":"string"},"paymentSignature":{"type":"string"},"supportedAccountImplementation":{"type":"string"},"domain":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"chainId":{"type":"number"},"verifyingContract":{"type":"string"}},"required":["name","version","chainId","verifyingContract"]},"types":{"description":"EIP-712 type definitions"},"primaryType":{"type":"string","enum":["Intent"]},"signature":{"type":"string"}},"required":["chainId","eoa","executionData","nonce","derivationNonce","payer","paymentToken","paymentMaxAmount","combinedGas","encodedPreCalls","encodedFundTransfers","settler","expiry","isMultichain","funder","funderSignature","settlerContext","paymentAmount","paymentRecipient","paymentSignature","supportedAccountImplementation","domain","types","primaryType","signature"]}},"delegations":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"address":{"type":"string"},"contractAddress":{"type":"string"},"derivationNonce":{"type":"number"},"authorizationNonce":{"type":"number"},"signature":{"type":"string"}},"required":["chainId","address","contractAddress","derivationNonce","authorizationNonce","signature"]}},"quoteId":{"description":"Quote ID from quote response","type":"string"}},"required":["intents","delegations","quoteId"]},{"additionalProperties":false,"title":"PoolWithdrawSubmitRequest","type":"object","properties":{"quoteId":{"description":"Quote ID from pool-withdraw quote response","type":"string"},"withdrawals":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"commitmentId":{"description":"Pool commitment DB ID","type":"string"},"calldata":{"description":"Encoded Entrypoint.relay() calldata (hex)","type":"string"},"changeNullifierHash":{"description":"Nullifier hash of the change commitment created by a partial withdrawal (stringified bigint)","type":"string"}},"required":["commitmentId","calldata"]}}},"required":["quoteId","withdrawals"]},{"additionalProperties":false,"title":"ConversionRecoverSubmitRequest","type":"object","properties":{"quoteId":{"description":"Quote ID from pool-recover quote response","type":"string"},"recoverCalldata":{"description":"Encoded Pool.recover(proof) calldata (hex)","type":"string"},"intents":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"eoa":{"type":"string"},"executionData":{"type":"string"},"nonce":{"type":"string"},"derivationNonce":{"type":"string"},"payer":{"type":"string"},"paymentToken":{"type":"string"},"paymentMaxAmount":{"type":"string"},"combinedGas":{"type":"string"},"encodedPreCalls":{"type":"array","items":{"type":"string"}},"encodedFundTransfers":{"type":"array","items":{"type":"string"}},"settler":{"type":"string"},"expiry":{"type":"string"},"isMultichain":{"type":"boolean"},"funder":{"type":"string"},"funderSignature":{"type":"string"},"settlerContext":{"type":"string"},"paymentAmount":{"type":"string"},"paymentRecipient":{"type":"string"},"paymentSignature":{"type":"string"},"supportedAccountImplementation":{"type":"string"},"domain":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"chainId":{"type":"number"},"verifyingContract":{"type":"string"}},"required":["name","version","chainId","verifyingContract"]},"types":{"description":"EIP-712 type definitions"},"primaryType":{"type":"string","enum":["Intent"]},"signature":{"type":"string"}},"required":["chainId","eoa","executionData","nonce","derivationNonce","payer","paymentToken","paymentMaxAmount","combinedGas","encodedPreCalls","encodedFundTransfers","settler","expiry","isMultichain","funder","funderSignature","settlerContext","paymentAmount","paymentRecipient","paymentSignature","supportedAccountImplementation","domain","types","primaryType","signature"]}},"delegations":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"address":{"type":"string"},"contractAddress":{"type":"string"},"derivationNonce":{"type":"number"},"authorizationNonce":{"type":"number"},"signature":{"type":"string"}},"required":["chainId","address","contractAddress","derivationNonce","authorizationNonce","signature"]}}},"required":["quoteId","recoverCalldata","intents","delegations"]}]}},"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"success":{"type":"boolean"},"quoteId":{"type":"string"},"status":{"type":"string"},"message":{"type":"string"}},"required":["success","quoteId","status","message"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}},{"status":"403","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Forbidden","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"404","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Not found","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"409","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Conflict","type":"string"},"message":{"type":"string"},"code":{"example":"QUOTE_LOCK_CONFLICT","type":"string"}},"required":["error","message"]}},{"status":"451","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unavailable","type":"string"},"message":{"type":"string"},"code":{"anyOf":[{"type":"string","enum":["GEO_RESTRICTED"]},{"type":"string","enum":["TOKENIZED_ASSET_GEO_RESTRICTED"]}]},"recoveryUrl":{"type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### Get relay status

<EndpointCard data={{"method":"GET","path":"/v1/accounts/{accountId}/relay-status/{quoteId}","operationId":"getRelayStatus","tags":["Transact"],"description":"Get the relay transaction status and hash for a submitted quote.","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true},{"schema":{"type":"string"},"in":"path","name":"quoteId","required":true}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"status":{"type":"string"},"chainId":{"type":"number"},"txHash":{"anyOf":[{"type":"string"},{"type":"null"}]},"confirmedTxHash":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["status","chainId","txHash","confirmedTxHash"]}},{"status":"404","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Not found","type":"string"},"message":{"type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### Unlock quote

<EndpointCard data={{"method":"POST","path":"/v1/accounts/{accountId}/unlock","operationId":"unlockQuote","tags":["Transact"],"description":"Release the lock held by a quote so the funds become available for a new transaction. Use when the user cancels a send or the client decides not to submit.","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"requestBody":{"required":true,"schema":{"additionalProperties":false,"type":"object","properties":{"quoteId":{"description":"Quote ID from quote response","type":"string"}},"required":["quoteId"]}},"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"404","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Not found","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"451","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unavailable","type":"string"},"message":{"type":"string"},"code":{"anyOf":[{"type":"string","enum":["GEO_RESTRICTED"]},{"type":"string","enum":["TOKENIZED_ASSET_GEO_RESTRICTED"]}]},"recoveryUrl":{"type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### Get max spendable

<EndpointCard data={{"method":"POST","path":"/v1/accounts/{accountId}/max-spendable","operationId":"getMaxSpendable","tags":["Transact"],"description":"Calculate the maximum spendable amount for a token, accounting for relay fees, swap gas, and pool fees when applicable. Use this to power the \"max\" button in send, swap, and pool UIs.","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"requestBody":{"required":true,"schema":{"additionalProperties":false,"type":"object","properties":{"chainId":{"description":"Chain ID (must support Porto)","type":"number"},"token":{"description":"Token address (0x...)","type":"string"},"type":{"description":"Transaction type — swap, pool-deposit, boost-deposit, and off-ramp subtract additional gas/service fees","anyOf":[{"type":"string","enum":["send"]},{"type":"string","enum":["swap"]},{"type":"string","enum":["pool-deposit"]},{"type":"string","enum":["boost-deposit"]},{"type":"string","enum":["off-ramp"]}]},"tokenOut":{"description":"Token address to buy (required for type=swap)","type":"string"},"slippageMode":{"description":"Slippage mode for swap max-spendable. auto asks the route provider to calculate slippage; manual uses slippageBps. Responses omit slippageBps when the route has no explicit slippage value.","anyOf":[{"type":"string","enum":["auto"]},{"type":"string","enum":["manual"]}]},"slippageBps":{"description":"Manual slippage tolerance in bps (type=swap, 1-500)","minimum":1,"maximum":500,"type":"number"},"tokenOutChainId":{"description":"Destination chain ID for cross-chain swaps","type":"number"},"spendableAddresses":{"description":"Optional address-held funding sources to use exactly for this max calculation.","minItems":1,"maxItems":50,"type":"array","items":{"description":"Selectable spendable address","type":"string"}}},"required":["chainId","token","type"]}},"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"maxAmount":{"description":"Maximum spendable amount in smallest unit","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit","type":"string"},"feeEstimateUsdAmount":{"description":"USD value of feeEstimate, or null when USD pricing is unavailable","anyOf":[{"type":"number"},{"type":"null"}]},"spendableCount":{"description":"Number of spendable UTXOs that will be consumed","type":"number"},"grossAmount":{"description":"Gross deposit amount including vetting fee (pool-deposit only)","type":"string"},"fees":{"type":"object","properties":{"network":{"description":"Gas/relay fee estimate","type":"string"},"vetting":{"description":"On-chain vetting fee","type":"string"},"deposit":{"description":"Cloaked service fee (0 if waived)","type":"string"},"service":{"description":"Vetting + deposit combined","type":"string"},"total":{"description":"Network + service total","type":"string"}},"required":["network","vetting","deposit","service","total"]},"protocolFeeBps":{"description":"Protocol fee rate in bps (swap only)","type":"number"},"protocolFeeAmount":{"description":"Protocol fee amount in smallest unit (swap only)","type":"string"}},"required":["maxAmount","feeEstimate","spendableCount"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"403","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Forbidden","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"451","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unavailable","type":"string"},"message":{"type":"string"},"code":{"anyOf":[{"type":"string","enum":["GEO_RESTRICTED"]},{"type":"string","enum":["TOKENIZED_ASSET_GEO_RESTRICTED"]}]},"recoveryUrl":{"type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### Create swap preview

<EndpointCard data={{"method":"POST","path":"/v1/accounts/{accountId}/swap-preview","operationId":"createSwapPreview","tags":["Transact"],"description":"Get a swap preview (price discovery) without reserving balances.","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"requestBody":{"required":true,"schema":{"additionalProperties":false,"type":"object","properties":{"chainId":{"description":"Chain ID","type":"number"},"tokenIn":{"description":"Token address being sold","type":"string"},"tokenOut":{"description":"Token address being bought","type":"string"},"amountIn":{"description":"Amount to swap in smallest unit (stringified bigint)","type":"string"},"slippageMode":{"description":"Slippage selection mode. auto asks the route provider to calculate slippage; manual uses slippageBps. Responses omit slippageBps when the route has no explicit slippage value.","anyOf":[{"type":"string","enum":["auto"]},{"type":"string","enum":["manual"]}]},"slippageBps":{"description":"Manual slippage tolerance in basis points (e.g. 50 = 0.5%, max: 500 = 5%)","minimum":1,"maximum":500,"type":"number"},"tokenOutChainId":{"description":"Destination chain ID for cross-chain swaps","type":"number"},"spendableAddresses":{"description":"Optional address-held funding sources to use exactly for this swap preview.","minItems":1,"maxItems":50,"type":"array","items":{"description":"Selectable spendable address","type":"string"}}},"required":["chainId","tokenIn","tokenOut","amountIn"]}},"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"expectedOutput":{"type":"string"},"minimumOutput":{"type":"string"},"outputToken":{"type":"string"},"outputDecimals":{"type":"number"},"outputSymbol":{"type":"string"},"routing":{"type":"string"},"slippageMode":{"anyOf":[{"type":"string","enum":["auto"]},{"type":"string","enum":["manual"]}]},"slippageBps":{"description":"Effective slippage tolerance in basis points. Omitted when the route has no explicit slippage value.","type":"number"},"requestedSlippageBps":{"type":"number"},"feeEstimate":{"type":"string"},"estimatedFillTimeMs":{"type":"number"},"protocolFeeBps":{"type":"number"},"protocolFeeAmount":{"type":"string"},"priceImpact":{"type":"number"},"rateOnly":{"type":"boolean"}},"required":["expectedOutput","minimumOutput","outputToken","outputDecimals","outputSymbol","routing","slippageMode","feeEstimate","protocolFeeBps","protocolFeeAmount"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}},{"status":"403","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Forbidden","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"429","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Too Many Requests","type":"string"},"message":{"example":"Rate limit exceeded. Maximum 30 requests per 1 minute.","type":"string"}},"required":["error","message"]}},{"status":"451","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unavailable","type":"string"},"message":{"type":"string"},"code":{"anyOf":[{"type":"string","enum":["GEO_RESTRICTED"]},{"type":"string","enum":["TOKENIZED_ASSET_GEO_RESTRICTED"]}]},"recoveryUrl":{"type":"string"}},"required":["error","message"]}},{"status":"502","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad Gateway","type":"string"},"message":{"type":"string"},"code":{"example":"SWAP_UNAVAILABLE","type":"string"}},"required":["error","message"]}},{"status":"503","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Service Unavailable","type":"string"},"message":{"type":"string"},"code":{"example":"SERVER_BUSY","description":"Machine-readable reason, such as SERVER_BUSY or POOL_STATE_REFRESHING.","type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### Recover conversion prepare

<EndpointCard data={{"method":"POST","path":"/v1/accounts/{accountId}/pool-recover/prepare","operationId":"recoverConversionPrepare","tags":["Transact"],"description":"Build an unsigned Porto intent and delegation for a pool recover (ragequit). The client calls this after generating the commitment proof, signs the returned intent and delegation, then submits via the standard submit endpoint.","parameters":[{"schema":{"type":"string"},"in":"path","name":"accountId","required":true}],"requestBody":{"required":true,"schema":{"type":"object","properties":{"quoteId":{"description":"Quote ID from pool-recover quote response","type":"string"},"recoverCalldata":{"description":"Encoded Pool.ragequit(proof) calldata (hex)","type":"string"}},"required":["quoteId","recoverCalldata"]}},"responses":[{"status":"200","description":"Default Response"}],"requiresAuth":true}} />

#### Get pool state

<EndpointCard data={{"method":"GET","path":"/v1/accounts/{accountId}/pool/state","operationId":"getPoolState","tags":["Transact"],"description":"Get the current incognito pool state for an account and token. Returns the Merkle tree, ASP leaves, and your commitments — everything the client needs to build ZK withdrawal proofs.","parameters":[{"schema":{"type":"number"},"in":"query","name":"chainId","required":true,"description":"Chain ID of the pool"},{"schema":{"type":"string"},"in":"query","name":"token","required":true,"description":"Token address accepted by the pool (0x...)"},{"schema":{"anyOf":[{"type":"string","enum":["deposit"]},{"type":"string","enum":["withdraw"]}]},"in":"query","name":"purpose","required":false,"description":"When set to withdraw, the route returns POOL_STATE_REFRESHING unless proof inputs are ready."},{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"leaves":{"description":"State tree leaves in insertion order (stringified bigints)","type":"array","items":{"type":"string"}},"currentRoot":{"description":"Current Merkle root (stringified bigint)","type":"string"},"treeSize":{"description":"Number of leaves in the tree","type":"number"},"aspLeaves":{"description":"ASP-approved labels. In dev: from DB. In staging/production: verified against Entrypoint.latestRoot before being served.","type":"array","items":{"type":"string"}},"spentNullifiers":{"description":"All spent nullifiers from Withdrawn events — used for spent detection and change commitment discovery","type":"array","items":{"type":"object","properties":{"nullifierHash":{"description":"Spent nullifier hash (stringified bigint)","type":"string"},"withdrawnValue":{"description":"Withdrawn amount in wei (stringified bigint)","type":"string"},"newCommitment":{"description":"Change commitment hash (stringified bigint)","type":"string"}},"required":["nullifierHash","withdrawnValue","newCommitment"]}},"nextDepositIndex":{"description":"Next available deposit index for this account — use for precommitment derivation","type":"number"},"commitments":{"description":"This account's unspent pool commitments","type":"array","items":{"type":"object","properties":{"id":{"description":"Commitment DB ID","type":"string"},"depositIndex":{"type":"number"},"withdrawalIndex":{"type":"number"},"commitment":{"description":"On-chain commitment hash","type":"string"},"label":{"description":"On-chain label","type":"string"},"value":{"description":"Commitment value in wei","type":"string"},"aspStatus":{"description":"ASP approval status","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["approved"]},{"type":"string","enum":["declined"]}]}},"required":["id","depositIndex","withdrawalIndex","commitment","label","value","aspStatus"]}}},"required":["leaves","currentRoot","treeSize","spentNullifiers","nextDepositIndex","commitments"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}},{"status":"503","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Service Unavailable","type":"string"},"message":{"type":"string"},"code":{"example":"SERVER_BUSY","description":"Machine-readable reason, such as SERVER_BUSY or POOL_STATE_REFRESHING.","type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### Get pool commitments

<EndpointCard data={{"method":"GET","path":"/v1/accounts/{accountId}/pool/commitments","operationId":"getPoolCommitments","tags":["Transact"],"description":"Get this account's current incognito commitments for a supported pool without loading Merkle proof state.","parameters":[{"schema":{"type":"number"},"in":"query","name":"chainId","required":true,"description":"Chain ID of the pool"},{"schema":{"type":"string"},"in":"query","name":"token","required":true,"description":"Token address accepted by the pool (0x...)"},{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"commitments":{"description":"This account's unspent pool commitments","type":"array","items":{"type":"object","properties":{"id":{"description":"Commitment DB ID","type":"string"},"depositIndex":{"type":"number"},"withdrawalIndex":{"type":"number"},"commitment":{"description":"On-chain commitment hash","type":"string"},"label":{"description":"On-chain label","type":"string"},"value":{"description":"Commitment value in wei","type":"string"},"aspStatus":{"description":"ASP approval status","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["approved"]},{"type":"string","enum":["declined"]}]}},"required":["id","depositIndex","withdrawalIndex","commitment","label","value","aspStatus"]}}},"required":["commitments"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

### Cloakie

Cloakie NFT verification and withdrawal

#### Verify cloakie deposit

<EndpointCard data={{"method":"POST","path":"/v1/accounts/{accountId}/cloakie/verify","operationId":"verifyCloakieDeposit","tags":["Cloakie"],"description":"Scan recent unused stealth addresses for Cloakie NFTs on Base. Records any newly discovered deposits and activates the fee waiver.","parameters":[{"schema":{"type":"string"},"in":"path","name":"accountId","required":true}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"active":{"type":"boolean"},"deposits":{"type":"array","items":{"type":"object","properties":{"depositAddress":{"type":"string"},"tokenId":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["depositAddress","tokenId","imageUrl"]}}},"required":["active","deposits"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### Withdraw cloakie

<EndpointCard data={{"method":"POST","path":"/v1/accounts/{accountId}/cloakie/withdraw","operationId":"withdrawCloakie","tags":["Cloakie"],"description":"Build an intent to transfer a Cloakie NFT from a deposit address back to the user. Returns intents and delegations for client signing.","parameters":[{"schema":{"type":"string"},"in":"path","name":"accountId","required":true}],"requestBody":{"required":true,"schema":{"additionalProperties":false,"type":"object","properties":{"depositAddress":{"description":"Stealth address holding the Cloakie","type":"string"},"recipientAddress":{"description":"Address to send the Cloakie to","type":"string"},"tokenId":{"description":"Token ID of the Cloakie to withdraw (required if multiple at same address)","type":"string"}},"required":["depositAddress","recipientAddress"]}},"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"quoteId":{"type":"string"},"intents":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"eoa":{"type":"string"},"executionData":{"type":"string"},"nonce":{"type":"string"},"derivationNonce":{"type":"string"},"payer":{"type":"string"},"paymentToken":{"type":"string"},"paymentMaxAmount":{"type":"string"},"combinedGas":{"type":"string"},"encodedPreCalls":{"type":"array","items":{"type":"string"}},"encodedFundTransfers":{"type":"array","items":{"type":"string"}},"settler":{"type":"string"},"expiry":{"type":"string"},"isMultichain":{"type":"boolean"},"funder":{"type":"string"},"funderSignature":{"type":"string"},"settlerContext":{"type":"string"},"paymentAmount":{"type":"string"},"paymentRecipient":{"type":"string"},"paymentSignature":{"type":"string"},"supportedAccountImplementation":{"type":"string"},"domain":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"chainId":{"type":"number"},"verifyingContract":{"type":"string"}},"required":["name","version","chainId","verifyingContract"]},"types":{"description":"EIP-712 type definitions"},"primaryType":{"type":"string","enum":["Intent"]}},"required":["chainId","eoa","executionData","nonce","derivationNonce","payer","paymentToken","paymentMaxAmount","combinedGas","encodedPreCalls","encodedFundTransfers","settler","expiry","isMultichain","funder","funderSignature","settlerContext","paymentAmount","paymentRecipient","paymentSignature","supportedAccountImplementation","domain","types","primaryType"]}},"delegations":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"address":{"type":"string"},"contractAddress":{"type":"string"},"derivationNonce":{"type":"number"},"authorizationNonce":{"type":"number"}},"required":["chainId","address","contractAddress","derivationNonce","authorizationNonce"]}},"expiresAt":{"type":"string"},"signature":{"type":"string"},"depositAddress":{"type":"string"},"recipientAddress":{"type":"string"},"tokenId":{"type":"string"}},"required":["quoteId","intents","delegations","expiresAt","signature","depositAddress","recipientAddress","tokenId"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}},{"status":"404","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Not found","type":"string"},"message":{"type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

### Relayer

#### Relayer details

<EndpointCard data={{"method":"GET","path":"/relayer/details","operationId":"relayerDetails","tags":["Relayer"],"description":"Get relayer fee info for a given chain and asset","parameters":[{"schema":{"type":"number"},"in":"query","name":"chainId","required":true,"description":"Chain ID"},{"schema":{"type":"string"},"in":"query","name":"assetAddress","required":true,"description":"Asset address"}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"feeBPS":{"type":"string"},"feeReceiverAddress":{"type":"string"},"chainId":{"type":"number"},"assetAddress":{"type":"string"},"minWithdrawAmount":{"type":"string"},"maxGasPrice":{"type":"string"}},"required":["feeBPS","feeReceiverAddress","chainId","assetAddress","minWithdrawAmount","maxGasPrice"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"503","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Service Unavailable","type":"string"},"message":{"type":"string"},"code":{"example":"SERVER_BUSY","description":"Machine-readable reason, such as SERVER_BUSY or POOL_STATE_REFRESHING.","type":"string"}},"required":["error","message"]}}],"requiresAuth":false}} />

#### Relayer quote

<EndpointCard data={{"method":"POST","path":"/relayer/quote","operationId":"relayerQuote","tags":["Relayer"],"description":"Get a fee commitment for relaying a privacy pool withdrawal","parameters":[],"requestBody":{"required":true,"schema":{"additionalProperties":false,"type":"object","properties":{"chainId":{"description":"Chain ID","type":"number"},"amount":{"description":"Withdrawal amount in smallest token unit","type":"string"},"asset":{"description":"Asset address","type":"string"},"recipient":{"description":"Recipient address","type":"string"},"extraGas":{"description":"Fund recipient with gas","type":"boolean"}},"required":["chainId","amount","asset","recipient"]}},"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"baseFeeBPS":{"type":"string"},"feeBPS":{"type":"string"},"gasPrice":{"type":"string"},"feeCommitment":{"type":"object","properties":{"expiration":{"type":"number"},"asset":{"type":"string"},"withdrawalData":{"type":"string"},"signedRelayerCommitment":{"type":"string"},"extraGas":{"type":"boolean"},"amount":{"type":"string"}},"required":["expiration","asset","withdrawalData","signedRelayerCommitment","extraGas","amount"]},"detail":{"type":"object","properties":{"relayTxCost":{"type":"object","properties":{"gas":{"type":"string"},"eth":{"type":"string"}},"required":["gas","eth"]},"extraGasFundAmount":{"type":"object","properties":{"gas":{"type":"string"},"eth":{"type":"string"}},"required":["gas","eth"]},"extraGasTxCost":{"type":"object","properties":{"gas":{"type":"string"},"eth":{"type":"string"}},"required":["gas","eth"]}},"required":["relayTxCost"]}},"required":["baseFeeBPS","feeBPS","gasPrice","feeCommitment","detail"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"503","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Service Unavailable","type":"string"},"message":{"type":"string"},"code":{"example":"SERVER_BUSY","description":"Machine-readable reason, such as SERVER_BUSY or POOL_STATE_REFRESHING.","type":"string"}},"required":["error","message"]}}],"requiresAuth":false}} />

#### Relayer request

<EndpointCard data={{"method":"POST","path":"/relayer/request","operationId":"relayerRequest","tags":["Relayer"],"description":"Submit a privacy pool withdrawal for relay","parameters":[],"requestBody":{"required":true,"schema":{"additionalProperties":false,"type":"object","properties":{"withdrawal":{"type":"object","properties":{"processooor":{"type":"string"},"data":{"type":"string"}},"required":["processooor","data"]},"proof":{"type":"object","properties":{"pi_a":{"minItems":3,"maxItems":3,"type":"array","items":{"type":"string"}},"pi_b":{"minItems":3,"maxItems":3,"type":"array","items":{"minItems":2,"maxItems":2,"type":"array","items":{"type":"string"}}},"pi_c":{"minItems":3,"maxItems":3,"type":"array","items":{"type":"string"}},"protocol":{"type":"string","enum":["groth16"]},"curve":{"type":"string","enum":["bn128"]}},"required":["pi_a","pi_b","pi_c","protocol","curve"]},"publicSignals":{"minItems":8,"maxItems":8,"type":"array","items":{"type":"string"}},"scope":{"type":"string"},"chainId":{"type":"number"},"feeCommitment":{"type":"object","properties":{"expiration":{"type":"number"},"asset":{"type":"string"},"withdrawalData":{"type":"string"},"signedRelayerCommitment":{"type":"string"},"extraGas":{"type":"boolean"},"amount":{"type":"string"}},"required":["expiration","asset","withdrawalData","signedRelayerCommitment","extraGas","amount"]}},"required":["withdrawal","proof","publicSignals","scope","chainId","feeCommitment"]}},"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"success":{"type":"boolean"},"txHash":{"type":"string"},"error":{"type":"string"},"timestamp":{"type":"number"},"requestId":{"type":"string"}},"required":["success","timestamp","requestId"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"500","description":"Default Response","schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"503","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Service Unavailable","type":"string"},"message":{"type":"string"},"code":{"example":"SERVER_BUSY","description":"Machine-readable reason, such as SERVER_BUSY or POOL_STATE_REFRESHING.","type":"string"}},"required":["error","message"]}}],"requiresAuth":false}} />

### Send

#### Resolve send destination avatar

<EndpointCard data={{"method":"GET","path":"/v1/accounts/{accountId}/destination-avatar","operationId":"resolveSendDestinationAvatar","tags":["Send"],"description":"Resolve the public ENS avatar URL for a send destination. Returns null when the destination is not an ENS name or no public avatar is configured.","parameters":[{"schema":{"minLength":1,"maxLength":255,"type":"string"},"in":"query","name":"destinationAddress","required":true,"description":"Destination address or ENS name entered in the send form."},{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"avatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["avatarUrl"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}},{"status":"403","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Forbidden","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"429","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Too Many Requests","type":"string"},"message":{"example":"Rate limit exceeded. Maximum 60 requests per 1 minute.","type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### Classify send recipient address

<EndpointCard data={{"method":"GET","path":"/v1/accounts/{accountId}/recipient-address-kind","operationId":"classifySendRecipientAddress","tags":["Send"],"description":"Classify a send recipient address as an EOA, EIP-7702 delegated EOA, or contract on the selected chain.","parameters":[{"schema":{"type":"number"},"in":"query","name":"chainId","required":true,"description":"Chain ID selected in the send form."},{"schema":{"minLength":42,"maxLength":42,"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"in":"query","name":"address","required":true,"description":"Raw 0x recipient address to inspect."},{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"kind":{"anyOf":[{"type":"string","enum":["eoa"]},{"type":"string","enum":["eip7702"]},{"type":"string","enum":["contract"]}]}},"required":["kind"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}},{"status":"403","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Forbidden","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"429","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Too Many Requests","type":"string"},"message":{"example":"Rate limit exceeded. Maximum 60 requests per 1 minute.","type":"string"}},"required":["error","message"]}},{"status":"502","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad Gateway","type":"string"},"message":{"type":"string"},"code":{"example":"SWAP_UNAVAILABLE","type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

### Account

#### Get contact email

<EndpointCard data={{"method":"GET","path":"/v1/accounts/{accountId}/contact-email","operationId":"getContactEmail","tags":["Account"],"description":"Return the account's optional contact email, or null if none is set.","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"email":{"anyOf":[{"minLength":3,"maxLength":320,"pattern":"^[^@\\s]+@[^@\\s]+\\.[^@\\s]+$","description":"Optional contact email for the account.","type":"string"},{"type":"null"}]}},"required":["email"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}},{"status":"403","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Forbidden","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"429","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Too Many Requests","type":"string"},"message":{"example":"Rate limit exceeded. Maximum 60 requests per 1 minute.","type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### Set contact email

<EndpointCard data={{"method":"PUT","path":"/v1/accounts/{accountId}/contact-email","operationId":"setContactEmail","tags":["Account"],"description":"Set or replace the account's optional contact email. Used for account updates, product news, and support/feedback outreach.","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"requestBody":{"required":true,"schema":{"type":"object","properties":{"email":{"minLength":3,"maxLength":320,"pattern":"^[^@\\s]+@[^@\\s]+\\.[^@\\s]+$","description":"Optional contact email for the account.","type":"string"}},"required":["email"]}},"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"email":{"anyOf":[{"minLength":3,"maxLength":320,"pattern":"^[^@\\s]+@[^@\\s]+\\.[^@\\s]+$","description":"Optional contact email for the account.","type":"string"},{"type":"null"}]}},"required":["email"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}},{"status":"403","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Forbidden","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"429","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Too Many Requests","type":"string"},"message":{"example":"Rate limit exceeded. Maximum 60 requests per 1 minute.","type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

#### Delete contact email

<EndpointCard data={{"method":"DELETE","path":"/v1/accounts/{accountId}/contact-email","operationId":"deleteContactEmail","tags":["Account"],"description":"Remove the account's contact email. Idempotent.","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"accountId","required":true,"description":"Account ID"}],"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"email":{"anyOf":[{"minLength":3,"maxLength":320,"pattern":"^[^@\\s]+@[^@\\s]+\\.[^@\\s]+$","description":"Optional contact email for the account.","type":"string"},{"type":"null"}]}},"required":["email"]}},{"status":"401","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Unauthorized","type":"string"},"message":{"type":"string"},"code":{"example":"UNAUTHORIZED","type":"string"}},"required":["error","message"]}},{"status":"403","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Forbidden","type":"string"},"message":{"type":"string"}},"required":["error","message"]}},{"status":"429","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Too Many Requests","type":"string"},"message":{"example":"Rate limit exceeded. Maximum 60 requests per 1 minute.","type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

### Simulation

#### Simulate transaction

<EndpointCard data={{"method":"POST","path":"/v1/simulate","operationId":"simulateTransaction","tags":["Simulation"],"description":"Simulate a transaction to preview asset changes before signing.","parameters":[],"requestBody":{"required":true,"schema":{"additionalProperties":false,"type":"object","properties":{"chainId":{"description":"Chain ID","type":"number"},"from":{"description":"Sender address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"to":{"description":"Target address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"value":{"description":"Value in wei (decimal string)","pattern":"^[0-9]+$","type":"string"},"data":{"description":"Calldata (hex string)","pattern":"^0x[a-fA-F0-9]*$","type":"string"}},"required":["chainId","from","to","value","data"]}},"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"success":{"type":"boolean"},"gasUsed":{"type":"number"},"assetChanges":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"token":{"type":"object","properties":{"address":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"number"},"name":{"type":"string"}},"required":["address"]},"from":{"type":"string"},"to":{"type":"string"},"amount":{"type":"string"},"rawAmount":{"type":"string"}},"required":["type","from","to","amount","rawAmount"]}},"error":{"type":"string"}},"required":["success","assetChanges"]}},{"status":"400","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Bad request","type":"string"},"message":{"type":"string"},"code":{"example":"BAD_REQUEST","type":"string"},"available":{"description":"Available balance in smallest unit (for INSUFFICIENT_BALANCE)","example":"0","type":"string"},"tokenSymbol":{"description":"Token symbol for the balance that caused the quote error","example":"ETH","type":"string"},"minAmount":{"description":"Human-readable minimum amount (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.00036 ETH","type":"string"},"maxSendable":{"description":"Maximum amount available after fees. Human-readable for WITHDRAWAL_AMOUNT_TOO_SMALL; smallest unit for INSUFFICIENT_FUNDS_FOR_FEES.","example":"0.018 ETH","type":"string"},"feeEstimate":{"description":"Estimated fee in smallest unit (for INSUFFICIENT_FUNDS_FOR_FEES)","example":"1000000000000000","type":"string"},"required":{"description":"Requested amount plus estimated fee in smallest unit","example":"1010000000000000000","type":"string"},"shortfall":{"description":"Amount by which the request exceeds the fee-adjusted maximum","example":"1000000000000000","type":"string"},"spendableCount":{"description":"Spendable count used for the fee-adjusted maximum","example":1,"type":"number"},"maxInputs":{"description":"Maximum input count allowed by the selector","example":50,"type":"number"},"selectedAmount":{"description":"Selected pool balance total considered for the quote (for WITHDRAWAL_AMOUNT_TOO_SMALL)","example":"0.02 ETH","type":"string"},"relayFee":{"description":"Estimated relay fee for the selected withdrawal balances","example":"0.0042 ETH","type":"string"},"feeLimit":{"description":"Maximum relay fee allowed for the requested withdrawal amount","example":"0.001 ETH","type":"string"},"maxRelayFeeBPS":{"description":"Maximum relay fee basis points allowed by the pool","example":1000,"type":"number"},"requiredRelayFeeBPS":{"description":"Required relay fee basis points for the requested withdrawal","example":"1523","type":"string"},"selectedCount":{"description":"Number of selected pool balances considered by the quote","example":2,"type":"number"}},"required":["error","message"]}},{"status":"403","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Forbidden","type":"string"},"message":{"type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />

### Utilities

#### Lookup function signatures

<EndpointCard data={{"method":"POST","path":"/v1/function-signatures","operationId":"lookupFunctionSignatures","tags":["Utilities"],"description":"Batch-resolve 4-byte function selectors to human-readable signatures. Uses a server-side cache backed by openchain.xyz.","parameters":[],"requestBody":{"required":true,"schema":{"type":"object","properties":{"selectors":{"minItems":1,"maxItems":20,"description":"Array of 4-byte hex selectors (e.g. [\"0xa9059cbb\"])","type":"array","items":{"pattern":"^0x[a-fA-F0-9]{8}$","type":"string"}}},"required":["selectors"]}},"responses":[{"status":"200","description":"Default Response","schema":{"type":"object","properties":{"signatures":{"description":"Map of selector → signature (null if unknown)","type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"required":["signatures"]}},{"status":"403","description":"Default Response","schema":{"type":"object","properties":{"error":{"example":"Forbidden","type":"string"},"message":{"type":"string"}},"required":["error","message"]}}],"requiresAuth":true}} />


## Careers

Cloaked doesn't have any open roles right now. We're grateful for your interest in what we're building.

That said, we're always glad to hear from people who care deeply about privacy, security, and great product design. If that's you, feel free to introduce yourself at [support@clkd.xyz](mailto\:support@clkd.xyz) — we keep an eye on these messages, and we'll reach out if a role opens up that fits.

Thanks for thinking of us. Check back here as the team grows.


## Developers

Cloaked provides API access for integrating Cloaked into your application or automating operations for teams. This page covers account types, authentication methods, API access, and signing flows.

### Account Types

#### Individual

Created automatically on registration. One signer, threshold of 1. Everything described in [How It Works](/docs/how-it-works) applies — an individual account is the default.

#### Team

Multiple signers with k-of-n threshold signing. Team accounts are created via the API and support:

* Configurable signer count and threshold (e.g. 2-of-3)
* API-key authenticated operations (payment address generation, quotes)
* Async signature collection — signers don't need to be online simultaneously
* Auto-relay when the signing threshold is met

### Authentication Methods

Cloaked's key model requires a single high-entropy secret to derive viewing and spending capabilities. That secret can come from any source that produces a deterministic, reproducible value.

#### Wallet Signatures

Sign a deterministic message with any EOA wallet (MetaMask, Rabby, hardware wallets, etc.). The signature is transformed into scoped capabilities via the same derivation described in [Key Derivation](/docs/how-it-works#key-derivation-model). A [PIN](/docs/faq#what-is-the-pin) is also required when using wallet connect — it is combined with your wallet address to construct the message your wallet signs, adding an explicit confirmation step that protects against blind signing. Passkey users do not need a PIN since the biometric prompt itself serves as the confirmation step.

#### Passkey PRFs

The [WebAuthn PRF extension](https://w3c.github.io/webauthn/#prf-extension) allows passkeys to return a deterministic secret bound to a relying party. No wallet required — biometric authentication (Face ID, fingerprint, Windows Hello) produces the entropy directly. Browser-native, phishing-resistant, and works on any device with a platform authenticator.

#### Embedded Wallets & Agents

For programmatic and agent use cases, embedded wallet providers (Privy, Turnkey, Fireblocks, etc.) can supply the signing entropy. This enables:

* Automated payment address generation
* Server-initiated sends via API keys
* Agent-driven operations without human-in-the-loop signing

### API Access

Team accounts authenticate via API keys for server-to-server integration. The API supports:

* **Payment addresses** — generate stealth addresses programmatically
* **Quotes** — coin selection and fee estimation
* **Sends** — build transactions, collect signatures, auto-relay

Individual accounts can also use API keys for the same operations.

### Signing Flow

#### Individual

The client signs the transaction directly, and it is relayed immediately.

#### Team

1. A quote locks the stealth addresses needed to cover the send amount
2. A transaction intent (the unsigned transaction details) is created from the quote, producing a digest
3. Each signer retrieves their derived key material and signs the digest
4. When the threshold is met, the transaction is assembled and relayed automatically

Signers can submit signatures independently and asynchronously — no coordinated online session is required.


## ENS Names

Your Cloaked identity is an [ENS](https://ens.domains/) name. When someone sends funds to that name, Cloaked resolves it to a **fresh stealth address** for each payment, so a single shareable name never turns into a single reused public address.

There are two ways to receive at an ENS name:

* **Your Cloaked subdomain:** a free `yourname.clkd.eth` name you pick during registration, with nothing to set up onchain.
* **A custom ENS name you own:** link an existing `.eth` name (e.g. `alice.eth`) so people can pay you at the name you already use, while you keep receiving at fresh stealth addresses.

You can use both at once. Linking a custom name does not disable your `clkd.eth` subdomain.

### Bring Your Own ENS Name

Linking a custom name points its resolver at Cloaked. You stay the owner of the name the whole time. Cloaked only becomes the **[resolver](https://docs.ens.domains/resolvers/quickstart/)**, the contract that answers "what address does this name point to?", and you can change it back at any point.

Once linked, anyone resolving your name (in a wallet, an explorer, or a dApp) is sent to a freshly derived stealth address, exactly like your `clkd.eth` subdomain.

#### How It Works

1. **Enter your name.** Type the ENS name you want to use (e.g. `alice.eth`). Cloaked checks that it's a valid `.eth` name and not already a `.clkd.eth` name.
2. **Connect the owning wallet.** Connect the wallet that owns the name, or owns its parent so it can create a [subname](https://docs.ens.domains/web/subdomains/). Cloaked reads the name's ownership and current resolver onchain to confirm you can manage it.
3. **Point it at Cloaked.** Approve a transaction that sets Cloaked's resolver for the name. If you'd rather dedicate a subname (e.g. `pay.alice.eth`), Cloaked creates that record instead and leaves your root name untouched.
4. **Confirm the link.** Cloaked verifies onchain that its resolver is now set, then stores the link to your account. From then on, the name resolves to fresh stealth addresses.

The resolver-change transaction is a normal ENS transaction on Ethereum mainnet, so you pay network gas for it. After that, resolution is handled by Cloaked at no onchain cost to senders.

#### Using a Subname

You don't have to commit your main name. If you want to keep `alice.eth` pointed wherever it is today, link a subname like `pay.alice.eth` or `clkd.alice.eth` to Cloaked instead. The subname resolves to stealth addresses while your root name keeps its existing resolver.

### Keeping Ownership

Linking is non-custodial in both directions:

* **You keep the name.** Cloaked is set only as the resolver, never the owner. Your ENS registration, expiry, and ownership are unchanged.
* **You can unlink anytime.** Set the name's resolver back to your previous choice (or any other resolver) and the link is removed. Cloaked never controls whether you can move your name elsewhere. See [Unlinking a Custom Name](#unlinking-a-custom-name) for the steps.

### Unlinking a Custom Name

Unlinking is the link in reverse: point the name's resolver away from Cloaked, then remove the name from your account. Your `clkd.eth` subdomain keeps working the whole time, and funds you've already received are unaffected.

1. **Open the unlink flow.** In the app, find your custom name under **Your ENS names** and choose **Unlink from Cloaked** from the menu next to it.
2. **Enter a new resolver.** Paste the resolver address the name should use from now on, such as the [ENS Public Resolver](https://docs.ens.domains/resolvers/public). It must be a resolver contract; a plain wallet address can't answer ENS queries.
3. **Connect the managing wallet and approve.** Connect the wallet that manages the name and approve the resolver-change transaction on Ethereum mainnet. Like linking, this is a normal ENS transaction, so you pay network gas.
4. **Cloaked removes the link.** Once the transaction confirms, Cloaked verifies onchain that its resolver is no longer set, then removes the name from your account. The name stops resolving to fresh stealth addresses.

**Already changed the resolver yourself?** If you've pointed the name at another resolver in the [ENS app](https://app.ens.domains/), or transferred the name to a new owner, choose **I manually updated ENS** in the unlink flow instead. Cloaked checks the change onchain and removes the link without another transaction. If you made the change moments ago, verification can briefly lag behind the chain; wait a minute and retry.

After unlinking, the name resolves to whatever its new resolver says, so set its address records if you want it to keep pointing at a wallet. You can link the name to Cloaked again at any time.

### Requirements & Limits

| Requirement                | Detail                                                                   |
| -------------------------- | ------------------------------------------------------------------------ |
| **An ENS name you manage** | You must own the name, or own its parent so you can create a subname.    |
| **Ethereum mainnet**       | The name and the resolver-change transaction live on Ethereum mainnet.   |
| **Not a `.clkd.eth` name** | Those are reserved for Cloaked subdomains and can't be linked as custom. |
| **One custom name**        | An account has one active custom ENS name at a time.                     |

### Privacy

The privacy benefit is the same as the rest of Cloaked: each payment lands at a distinct stealth address, so receives to your name don't pile up on one reused public address. Senders see only the address derived for their payment, never your other addresses.

Your custom name is stored on Cloaked only in encrypted form, under a key derived from your account that the server can't read. The name itself is public on Ethereum and anyone can resolve it, so the protection is in the fresh addresses behind it, not in hiding the name.

<details>
  <summary><h3>Advanced</h3></summary>

  Cloaked resolves names through an [offchain resolver](https://docs.ens.domains/resolvers/ccip-read/) that uses [CCIP-Read](https://eips.ethereum.org/EIPS/eip-3668). When you link a name, the onchain transaction sets that resolver as the name's address provider. A query for the name (`addr()`) is then deferred to Cloaked's gateway, which derives a fresh stealth address for your account and returns a signed response that the resolver verifies. This is the same mechanism that powers `clkd.eth` subdomains, so custom names and Cloaked subdomains resolve identically.

  Linking requires a signature from the name's manager so Cloaked can confirm the request comes from the controller, and Cloaked re-reads the resolver onchain before storing the link. Ownership reads use a configured RPC endpoint rather than the connected wallet's default provider, which avoids the rate-limited public endpoints that previously caused linking to fail in the browser.
</details>

### Further Reading

* [Using Cloaked](/docs/using-cloaked): registration and choosing your `clkd.eth` subdomain
* [How It Works](/docs/how-it-works): stealth address derivation and the receiving flow
* [ENS](https://ens.domains/): the Ethereum Name Service


## Frequently Asked Questions

### What is a stealth address?

An Ethereum-compatible address that only the recipient can recognize and control, generated using the recipient's public keys. A stealth address is still visible onchain, but it is not the same reused public address for every payment. [Learn more](https://eips.ethereum.org/EIPS/eip-5564).

### What happens after I receive at a fresh address?

Funds land at a fresh address controlled by your Cloaked account. That address is separate from your usual wallet address and from other fresh receives.

Deposit Review highlights the new receive so you can add a private tag, or move eligible balances into Incognito.

Funds at a fresh address stay separate until you use them. The address is still visible onchain, and if you later spend those funds together with funds from another source, that action can link the sources. [Learn more](/docs/tagging-and-deposit-reviews).

### What happens if I spend from multiple receive addresses?

Those addresses become linked by that transaction. This is how public blockchains work: a transaction that spends from multiple addresses reveals that those addresses were controlled together for that action.

Cloaked chooses the address-held balances needed to fund the action you are taking, whether you are sending, swapping, bridging, or cashing out. If you want more control, click **Select tags** before approving so you can choose which tagged balances to use.

### Can other people see my tags?

No. Tag names are encrypted before they are saved, and they are not written onchain. Cloaked stores encrypted tag data for your account, not readable tag names.

### Do tags make funds private?

Tags help you understand and control which balances you use together. They do not change transactions that are already visible onchain.

### Why did my `Incognito receive` tag disappear?

Cloaked carries the `Incognito receive` tag forward as long as those funds are not associated with any other visible history. If you receive Incognito funds and then swap them, the tag can stay with the swapped balance.

If you later send those funds together with funds from a different source, that action links the sources. At that point, Cloaked stops treating the whole balance as an Incognito receive, and the tag drops away.

### What happens to tags when I deposit into Incognito?

Tags from funds that enter Incognito do not carry through the privacy pool. The pool breaks the visible onchain history between the address that entered and the funds that later come out, so earlier address tags no longer apply.

### What is ENS?

A decentralized naming system that maps human-readable names (like `username.eth`) to Ethereum addresses and other resources. Cloaked uses ENS as a public entry point for generating stealth addresses. [Learn more](https://ens.domains/).

### What is the PIN?

A 4-digit PIN required only if you register with a connected wallet (MetaMask, Rabby, etc.). Passkey users do not need a PIN — the biometric prompt itself serves as the confirmation step.

The PIN is combined with your wallet address to construct a Cloaked-specific message that your wallet signs. That signature is then used to derive your viewing and spending capabilities. You will be prompted for your PIN whenever an action requires authorization.

The PIN never leaves your device and is never stored by Cloaked.

The primary purpose of the PIN is to interrupt mindless signing by requiring an explicit confirmation step for sensitive actions. Being prompted to enter your PIN is a signal that you are authorizing a sensitive Cloaked action. This makes accidental or blind signing much less likely and helps protect against phishing attempts that rely on tricking users into signing messages without understanding why.

**Important**: Cloaked does not store your PIN. Make sure to store your PIN securely.

### Does Cloaked custody my funds?

No. Cloaked never custodies your funds or private keys. Your funds remain fully under your control and are held onchain at stealth addresses derived from your keys. Only you can authorize and sign transactions. Cloaked provides coordination services (address derivation, balance tracking, and transaction construction) but cannot move funds independently.

### What happens if Cloaked goes offline?

Your funds remain safe and accessible onchain. Since Cloaked does not custody funds, your stealth addresses and their balances are unaffected by service downtime. However, while offline, you won't be able to:

* View your aggregated balance through Cloaked
* Generate new stealth addresses through Cloaked's service
* Construct and send transactions through Cloaked

You can always access your funds independently using the [recovery tool](https://recovery.clkd.xyz), which lets you rederive spending capabilities and stealth addresses without relying on the Cloaked service.

Cloaked is designed to pass the “walkaway test”: the system should continue to work even if the service becomes unavailable or the original developers disappear. This reflects a commitment to decentralization and user financial sovereignty.

> “We’re building decentralized applications. Applications that run without fraud, censorship or third-party interference. Applications that pass the walkaway test: they keep running even if the original developers disappear.” - [Vitalik](https://x.com/VitalikButerin/status/2006737662942871574)

If you send transactions from stealth addresses outside of Cloaked, Cloaked may not be aware of those transactions. This can cause your displayed balance to be incorrect or transactions to appear missing until the system re-syncs.

### What is a privacy pool?

A privacy pool is a smart contract where multiple users deposit funds together. After a compliance approval step, you can withdraw or spend from the pool using a zero-knowledge proof — which breaks the direct on-chain link between your deposit and withdrawal. This gives you an "Incognito balance" that on-chain observers cannot link back to your original deposit. [Learn more](/docs/privacy-pools).

### What is the Incognito balance?

Your Incognito balance is made up of funds in privacy pools. After a compliance approval step, pooled funds can be used for private sends or swaps at any time. Privacy grows as more people deposit into the pool. [Learn more](/docs/privacy-pools#balance-tiers).

### Can Cloaked see my privacy pool activity?

Yes. Cloaked's relay service submits transactions on your behalf, which means the Cloaked server can observe the link between your deposits and withdrawals. On-chain observers cannot. This is a trade-off of using Cloaked's managed experience versus interacting with privacy pool contracts directly.

If you want to withdraw from a privacy pool without Cloaked's relay involvement, you can use [recovery.clkd.xyz](https://recovery.clkd.xyz) to export your private key and then withdraw with a different relayer through [privacypools.com](https://www.privacypools.com/). Note that recovery.clkd.xyz runs entirely client-side — it re-derives your keys locally and does not communicate with Cloaked's servers. This way Cloaked has no visibility into the withdrawal. However, withdrawing outside of Cloaked means your Cloaked wallet will not be aware of the withdrawal — your displayed balances and transaction history may be incorrect or show unexpected behavior.

[Learn more](/docs/privacy-pools#trust-model).


## How It Works

Cloaked gives users fresh receive addresses while keeping one usable wallet experience.

Cloaked is self-custodial. It can generate addresses, scan the chain, track balances, and prepare transactions for you, but only you can sign and move funds.

This is achieved using a capability-based key derivation model.

### Key Derivation Model

When you register, a high-entropy secret is produced on your device — either from a passkey (via biometric prompt) or from a wallet signature protected by a [PIN](/docs/faq#what-is-the-pin). On the client, this secret is deterministically transformed into two **scoped cryptographic capabilities**:

* **Viewing capability**\
  Shared with the service. Allows detection of which stealth addresses belong to you, enables balance tracking, and allows the service to derive new stealth addresses.

* **Spending capability**\
  Retained entirely by the client. Required to authorize and sign transactions from stealth addresses.

These capabilities are not wallet private keys. They are derived, scoped, and re-derivable from your original secret (passkey or wallet signature). Only you can authorize spending. The spending capability never leaves your device.

This separation allows the service to coordinate stealth addresses on your behalf without custody or signing authority.

### Receiving Funds

When someone sends you funds, they can use the Cloaked [ENS](https://ens.domains/) name you choose during setup, a linked ENS name you own, or a payment address generated through the app or API.

Behind the scenes, the service:

* Derives a unique stealth address for each payment
* Monitors the blockchain for funds sent to that address
* Aggregates balances across all stealth addresses associated with you

Each payment lands at a distinct onchain address. That keeps different receives from automatically sharing one reused public address.

Senders never see your other stealth addresses, past or future.

<details>
  <summary><h3>Advanced</h3></summary>

  ##### Stealth Address Derivation

  Stealth addresses are derived using elliptic-curve Diffie–Hellman (ECDH), following the principles described in [ERC-5564](https://eips.ethereum.org/EIPS/eip-5564) and related implementations (e.g. Umbra).

  Address creation requires only public data derived from your spending and viewing keys. No private keys are shared with senders.

  In Cloaked’s architecture, address derivation and scanning are handled off-device for performance and UX, while spending authority remains entirely client-side.
</details>

### Sending Funds

Stealth addresses fragment your balance across many independent addresses. Sending funds requires safely recombining those balances.

At a high level, the service:

* Selects funds from one or more stealth addresses
* Constructs a transaction covering the send amount and fees
* Routes any change to a newly derived stealth address to avoid reuse

Your self-custody wallet authorizes and signs all transactions.

If one send uses multiple addresses, that transaction links those addresses onchain. Cloaked normally optimizes automatically, but where Advanced Control is enabled, users can choose exact address-held balances before requesting a quote.

<details>
  <summary><h3>Advanced</h3></summary>

  Cloaked uses [EIP-7702](https://eips.ethereum.org/EIPS/eip-7702) to upgrade stealth EOAs into [Porto](https://porto.sh/) smart accounts, imbuing Cloaked stealth addresses with the flexibility of smart accounts such as in-kind gas sponsorship and support for operations like swaps and bridging. This makes it practical to combine funds from many stealth addresses into a single send while preserving privacy and avoiding address reuse. All execution is explicitly authorized by the user’s wallet, while the service handles transaction coordination without requiring the user to deploy or manage smart contracts.
</details>

### What Is Visible Onchain

Fresh receives do not hide every blockchain event. They avoid building everything on one address.

| Visible event               | What it means                                          |
| --------------------------- | ------------------------------------------------------ |
| Receive to a fresh address  | Funds arrived at an address generated for your account |
| Balance at that address     | That address holds funds until you spend or move them  |
| Send from one address       | That address paid the destination                      |
| Send from several addresses | Those addresses are linked by the transaction          |
| Change output               | Leftover funds are routed to a new generated address   |

The privacy boundary is practical separation. Fresh addresses help keep unrelated activity apart until user behavior or a later transaction connects it.

### Privacy Pools

Cloaked integrates [Privacy Pools](https://docs.privacypools.com/) to offer an additional layer of privacy. By depositing funds into a compliant privacy pool, your balance is grouped with other deposits. After compliance approval, you can send or swap from your Incognito balance. Note that while the on-chain link to your original deposit is broken, Cloaked's relay service has visibility into both sides of the transaction.

See [Privacy Pools](/docs/privacy-pools) for a full explanation of how pooling works, the balance tiers, and the trust model.


## Off Ramp

Cloaked integrates [Peer](https://peer.xyz/) to let you sell crypto for fiat through a peer-to-peer escrow flow. Peer is operated by P2P Labs Inc. and provides an app and interface for accessing a peer-to-peer escrow protocol. Your crypto is deposited into an onchain escrow, a matched buyer sends fiat to your payment handle, and the escrow releases the crypto once the payment is proven.

The buyer never receives custody of your crypto before payment, and Cloaked does not custody your funds. Cloaked coordinates the quote, routing, signatures, and onchain submission so you can cash out from visible balances or from your Incognito balance.

### How It Works

1. **Choose payment details** — Select a supported payment method and enter the fiat destination details required by Peer.
2. **Preview the cash out** — Enter the asset and amount you want to sell. Cloaked estimates the fiat amount, route, network costs, and service fee.
3. **Confirm** — Sign with your passkey or wallet. Cloaked submits the transaction that moves the selected crypto into the Peer escrow.
4. **Settlement** — A buyer sends fiat through the selected payment method. Once the payment is proven, the escrowed crypto is released to the buyer.

### Routes

Cloaked automatically chooses the simplest route for the funds you want to sell.

| Route                    | When it applies                  | What happens                                                                                         |
| ------------------------ | -------------------------------- | ---------------------------------------------------------------------------------------------------- |
| **Direct**               | USDC on Base                     | Funds are deposited directly into the Peer escrow.                                                   |
| **Swap**                 | Non-USDC token on Base           | Cloaked swaps the token into USDC, then deposits USDC into escrow.                                   |
| **Bridge**               | Funds on another supported chain | Cloaked bridges or swaps the funds to USDC on Base before escrow deposit.                            |
| **Incognito withdrawal** | Privacy pool balance             | Cloaked withdraws from your Incognito balance, bridges to Base if needed, then deposits into escrow. |

The escrow currently settles in USDC on Base. If your source funds are on another chain or in another token, the quote includes the required swap or bridge steps.

### Payment Details

Cloaked uses Peer to access a peer-to-peer escrow flow with payment proof and verification. Supported fiat destinations depend on Peer availability, buyer activity, and selected payment methods, and may include payment methods such as Venmo, Revolut, Wise, PayPal, Zelle, or Cash App.

Cloaked stores a hashed reference to your payment details for the cash-out flow. Raw payment details are handled through the Peer integration rather than stored as plain text by Cloaked, and may be processed by Peer or made available as needed for buyers to complete payment. Peer's [Privacy Policy](https://www.peer.xyz/pp) and [Terms of Service](https://www.peer.xyz/tos) apply to Peer's handling of the off-ramp flow.

### Statuses

After you confirm a cash out, the order can move through several statuses:

* **Pending** — Cloaked is waiting for the escrow deposit transaction to confirm.
* **Awaiting fill** — The escrow deposit is open and waiting for a buyer.
* **Filling** — A buyer has locked the order and is completing fiat payment.
* **Completed** — The order was filled and the fiat payment was sent.
* **Recoverable** — Funds from a canceled or expired order can be claimed back.
* **Cancelled or failed** — The order closed without completing.

Partially filled orders can happen when only part of the escrow amount is matched. In that case, the filled portion settles normally and the remaining amount can be canceled or recovered when it becomes available.

### Cancels and Recovery

You can cancel an open cash out before it completes. If no buyer has locked funds, cancellation can return the remaining escrowed crypto quickly. If a buyer has already locked an order, those funds may need to wait until the buyer's payment window expires before they become recoverable.

Cloaked tracks this state and shows when recovery is available. Recovery sends claimable funds back to your Cloaked balance.

### Fees

* **Network fee** — Gas and routing costs for swaps, bridges, escrow deposits, cancellations, or recovery transactions.
* **Cloaked fee** — A service fee shown in the quote before you confirm.
* **Route costs** — Swap slippage or bridge costs may apply depending on the route.

All applicable fees and estimated proceeds are disclosed before transaction execution.

### Trust Model

Off ramping involves three distinct systems:

* **Cloaked** coordinates account selection, routing, transaction construction, and relay submission. Cloaked cannot move funds without your authorization.
* **Peer** provides the app and interface for accessing the peer-to-peer escrow protocol, including payment proof and verification flows.
* **The buyer** sends fiat through the selected payment method.

When cashing out from an Incognito balance, the privacy pool still breaks the public onchain link between your original deposit and withdrawal. However, as with other managed privacy pool actions, Cloaked's relay service can observe the relationship because it coordinates the transaction.

### Further Reading

* [Peer](https://peer.xyz/) — peer-to-peer cash-out protocol
* [Privacy Pools](/docs/privacy-pools) — Incognito balances and privacy pool trust model
* [Swaps & Bridging](/docs/swaps) — routing assets across tokens and chains


## Passkey Safety

If you registered with a passkey (instead of connecting an external wallet), your passkey is the primary way to access your account. There is no password reset or seed phrase.

You can create a **backup** — a password-encrypted file containing your keys — as a safety net. If you lose your passkey, the backup lets you recover your funds at [recovery.clkd.xyz](https://recovery.clkd.xyz). See [Account Recovery](/docs/recovery) for full details.

Even with a backup, keeping your passkey synced is important — it's your primary access method for day-to-day use.

Before signing out or switching devices, make sure your passkey is **synced to a cloud-backed password manager** so it's available on all your devices.

### Checking your passkey is synced

#### Apple (iCloud Keychain)

1. Open **Settings** on your iPhone, iPad, or Mac.
2. Tap **Passwords** (or search for it).
3. Search for **Cloaked** or your Cloaked domain.
4. Confirm you see a passkey entry — if it's there, it's synced across all your Apple devices signed into the same iCloud account.

iCloud Keychain syncs passkeys automatically. If you registered your passkey on an Apple device and iCloud Keychain is enabled, you're all set.

#### Google (Google Password Manager)

1. Go to [passwords.google.com](https://passwords.google.com) or open **Settings > Passwords** on your Android device.
2. Search for **Cloaked**.
3. Confirm you see a passkey entry — if it's there, it's synced across all your devices signed into the same Google account.

Google Password Manager syncs passkeys across Android devices and Chrome on desktop.

#### Other password managers

Some third-party password managers (1Password, Dashlane, etc.) also support passkeys. Check your password manager's passkey section to confirm the Cloaked entry is stored there.

### What if I can't find my passkey?

If you're currently signed in but can't find your passkey in any password manager, your passkey may be stored only on your current device. This means it won't be available if you lose the device or factory reset it.

If you're unsure, **stay signed in** until you can confirm your passkey is backed up. If you need help, contact support at [support@clkd.xyz](mailto\:support@clkd.xyz).

### Tips

* **Don't disable cloud sync** for your password manager — this is what keeps your passkey available across devices.
* **Stay signed in** if you're unsure whether your passkey is synced. You can always check later.
* **Test on another device** — the most reliable way to confirm sync is to try signing in from a different device.


## Privacy Pools

Cloaked integrates [Privacy Pools](https://docs.privacypools.com/) to give you an **Incognito balance** — funds that have no direct on-chain link to your original deposit. Privacy Pools were introduced in the [original research paper](https://papers.ssrn.com/sol3/papers.cfm?abstract_id=4563364) by Buterin, Jacob, et al. and implemented by [0xbow](https://www.0xbow.io/).

### How It Works

1. **Deposit** — Move visible funds into a compliant privacy pool. Your deposit is grouped with other users' deposits.
2. **Approval** — An [Association Set Provider (ASP)](https://docs.privacypools.com/layers/asp) reviews the deposit for compliance with network policies. Once approved, your funds are ready to use.
3. **Send or swap** — Spend from your Incognito balance. A [zero-knowledge proof](https://ethereum.org/en/zero-knowledge-proofs/) authorizes the withdrawal without revealing which deposit is yours.

### Balance Tiers

Your Incognito balance is made up of funds sitting in the privacy pool after ASP approval. They can be used for private sends or swaps at any time. Privacy grows as more people deposit into the pool.

### Trust Model

Privacy pools break the **on-chain** link between your deposit and withdrawal. No external observer can connect the two by analyzing the blockchain.

However, Cloaked's [relay service](/docs/how-it-works#sending-funds) submits transactions on your behalf. This means **the Cloaked server can observe the association** between your deposit and withdrawal, because it coordinates both sides of the transaction.

This is a trade-off of using Cloaked versus interacting with privacy pool contracts directly. The benefit is a seamless UX — you don't need to manage proofs, gas, or contract calls yourself. The trade-off is that Cloaked, as the relay operator, has visibility into the link.

For users who need stronger privacy guarantees, the underlying [Privacy Pools protocol](https://docs.privacypools.com/) is open and can be used independently with different relayers. You can use [recovery.clkd.xyz](https://recovery.clkd.xyz) to export your private key and withdraw through [privacypools.com](https://www.privacypools.com/) directly. See the [FAQ](/docs/faq#can-cloaked-see-my-privacy-pool-activity) for details.

### Fees

* **Network fee** — Gas for the deposit or withdrawal transaction, displayed before you confirm.
* All applicable fees are disclosed before transaction execution.

### Compliance

Privacy pools are designed to be compatible with regulatory expectations. The [ASP approval](https://docs.privacypools.com/layers/asp) step ensures that deposits meet network compliance policies before funds can be used privately. This distinguishes privacy pools from [mixing services](https://ethereum.org/en/privacy/#mixers) — privacy is achieved within a compliant framework.

### Further Reading

* [Privacy Pools documentation](https://docs.privacypools.com/)
* [0xbow](https://www.0xbow.io/) — Privacy Pools implementation
* [How Cloaked Works](/docs/how-it-works) — key derivation, sending, and receiving


## Privacy Policy

**Last Updated:** June 24, 2026

***

### About Us

Cloaked Technologies, Inc. ("Cloaked", "we", "us") operates services through clkd.xyz, app.clkd.xyz, recovery.clkd.xyz, api.clkd.xyz, clkd.id, and related domains. We serve as the data controller for personal data processed through our services. This policy applies to all users of Cloaked's web application, mini-apps, and APIs.

### 1. Personal Data We Collect

#### 1.1 Information You Provide

* **Passkey / WebAuthn credential metadata** — credential ID and public key (used for authentication)
* **Backup data** — encrypted and held by you; we do not retain a copy
* **ENS names or subdomains** you register through the service
* **Off-ramp payment information** — payment method selection and payment destination details you provide when using cash-out features, such as publicly identifiable payment handles or similar identifiers. Cloaked stores only the hashed payment-detail reference needed to coordinate the off-ramp flow; raw payment destination details are handled through the Peer integration and may be processed by Peer.
* **Contact details** — email address, if you provide one in-app to receive account updates and product news, subscribe to updates, join a waitlist, or contact us. An in-app contact email is optional, kept in its own table separate from your stealth/address data, and can be removed at any time from Settings, which deletes it from our servers.

#### 1.2 Information Collected Automatically

* **Device and browser information** — user-agent, platform, screen size
* **IP address** — used transiently for rate limiting, abuse prevention, and sanctions/geographic access controls; not stored long-term
* **Session and authentication tokens** — for maintaining your authenticated session
* **Usage data** — pages visited, features used, error logs (for debugging and service improvement)

#### 1.3 Blockchain and Relay Data

* **Public wallet addresses** — including stealth addresses associated with your account
* **On-chain transaction data** — publicly available on supported EVM-compatible blockchains
* **Token balances and transaction history** — indexed from public blockchain data
* **Relay transaction data** — signed transaction payloads submitted through our relay service, including transaction hashes, destination addresses, token amounts, and gas parameters. This data is retained temporarily for relay processing and monitoring, and becomes publicly available on-chain upon confirmation.
* **Off-ramp data** — when you use cash-out features, we process quote, route, escrow, payment-method, hashed payee reference, fee, conversion-rate, and lifecycle status data needed to move your authorized crypto transaction into a Peer escrow and track completion, cancellation, or recovery. On-chain escrow deposits, withdrawals, swaps, and bridge transactions become public blockchain data.
* **Privacy pool data** — when you use privacy pool features, the relay service processes both deposit and withdrawal transactions. Because Cloaked coordinates both sides, we can observe the association between your deposit and withdrawal. This data is retained to track balances and construct future transactions on your behalf.

Blockchain data is publicly accessible by nature. Our indexing of this data does not change its public status.

#### 1.4 Information We Do NOT Collect

* **Private keys** — your spending capability never leaves your device
* **PRF secrets or raw biometric data** — processed entirely on your device by the platform's WebAuthn implementation
* **PINs** — PINs are handled entirely on your device and are never transmitted to or stored by Cloaked

There is no obligation to provide personal data. However, the services cannot function without the data strictly necessary for their operation (e.g. passkey credentials for authentication).

### 2. How We Collect Information

We collect information through:

* Account creation and service usage
* Website and application interactions
* Transaction relay processing
* API usage
* Off-ramp quote, escrow, cancellation, and recovery processing
* Electronic correspondence with us
* Blockchain indexing (publicly available data)

### 3. Legal Basis and Purposes

We process your personal data on the following legal bases:

**Contract Performance** — To provide and operate the services, including authentication, stealth address management, transaction construction, balance tracking, and customer support.

**Consent** — For service analysis, personalization, newsletters, product updates, support outreach, understanding why people stop using the service, and promotional communications. You may withdraw consent at any time, including by removing your contact email in Settings.

**Legitimate Interests** — To maintain and improve our infrastructure, develop new features, detect and prevent security threats, and ensure service reliability.

**Legal Compliance** — To comply with applicable laws and regulations, respond to legal requests, and enforce our Terms of Service.

### 4. Data Retention

We retain personal data for as long as it is needed for the purposes for which it was collected and in accordance with legal and regulatory requirements. When personal data is no longer necessary, it is deleted or anonymized.

Blockchain data is permanent by nature and cannot be deleted from public blockchains.

### 5. Data Recipients

We may share personal data with third-party service providers who assist in operating the services. These include:

* **Cloud infrastructure providers** (e.g. AWS, Hetzner) — for hosting and data storage
* **Blockchain RPC providers** (e.g. Alchemy) — for blockchain network access
* **Third-party protocols** (e.g. Uniswap) — for swap routing (only public blockchain data)
* **Peer-to-peer escrow services and interfaces** (e.g. [Peer](https://www.peer.xyz/), operated by P2P Labs Inc.) — for peer-to-peer cash-out flows, payment proof, verification, and escrow settlement. Information needed for the off-ramp flow may be processed by Peer as described in its [Privacy Policy](https://www.peer.xyz/pp). Peer may process payment identifiers you choose to provide and may make them available as needed for buyers to complete payment. Depending on the selected payment method, information may also be processed by the relevant fiat payment platform. These third parties process information under their own terms and privacy practices. Cloaked does not control Peer, fiat payment processing, buyer behavior, trade execution on the protocol, or third-party payment platform data handling.
* **Privacy pool protocols** (e.g. 0xbow Privacy Pools) — for pool deposits and withdrawals. Deposit data is submitted to on-chain smart contracts and reviewed by an Association Set Provider (ASP) operated by a third party (0xbow Ltd.) for compliance approval. The ASP may collect and process data in accordance with its own [privacy policy](https://docs.privacypools.com/privacy-policy). Cloaked does not control the ASP's approval decisions or data handling practices.
* **Analytics providers** — for usage analytics (if applicable)

Service providers receive access only to the data necessary for their specific function and are bound by confidentiality obligations.

### 6. Data Transfers

Personal data may be transferred to and processed in the United States, the European Union/EEA, and other jurisdictions. For transfers to jurisdictions that lack an adequacy decision, we implement appropriate safeguards, which may include standard contractual clauses or other approved transfer mechanisms.

### 7. Data Security

We implement reasonable technical and organizational security measures to protect your data against unauthorized access, manipulation, loss, or disclosure. These include encryption at rest and in transit, access controls, and regular security assessments.

Our passkey-based authentication model means there are no passwords to be compromised. Employees and service providers with data access are bound by confidentiality obligations and must comply with applicable data protection laws.

### 8. Cookies and Local Storage

We use:

* **Session cookies** — to maintain your authenticated session
* **Local storage** — for wallet state, preferences, and application data
* **Analytics cookies** — only with your consent

We do not use third-party tracking cookies.

### 9. Your Rights

Depending on your jurisdiction, you may have the following rights regarding your personal data:

**Right of Access** — Request a copy of the personal data we hold about you.

**Right to Rectification** — Request correction of inaccurate or incomplete personal data.

**Right to Erasure** — Request deletion of your personal data when it is no longer necessary or was unlawfully processed.

**Right to Restriction** — Request that we limit processing of your personal data in certain circumstances.

**Right to Data Portability** — Request that your personal data be provided to you or another controller in a structured, commonly used, machine-readable format.

**Right to Object** — Object to processing of your personal data based on legitimate interests.

**Right to Withdraw Consent** — Withdraw consent at any time for processing based on consent, including marketing communications.

**Right to Lodge a Complaint** — File a complaint with a supervisory data protection authority in your jurisdiction.

To exercise any of these rights, contact us at [dev@clkd.xyz](mailto\:dev@clkd.xyz). We may need to verify your identity before processing your request.

### 10. Third-Party Links and Services

Our services may contain links to or integrations with third-party websites, protocols, or services (e.g. ENS, Uniswap, Porto, [Peer](https://www.peer.xyz/), 0xbow Privacy Pools). We have no control over the content, privacy policies, or practices of these third-party services and assume no responsibility for them.

### 11. California Privacy Rights (CCPA)

If you are a California resident, you have additional rights under the California Consumer Privacy Act (CCPA):

* **Right to Know** — You may request the categories and specific pieces of personal information we have collected about you.
* **Right to Delete** — You may request that we delete your personal information, subject to certain exceptions.
* **Right to Opt-Out** — You have the right to opt out of the "sale" or "sharing" of your personal information. **Cloaked does not sell or share your personal information** as defined under the CCPA.
* **Right to Non-Discrimination** — We will not discriminate against you for exercising any of your CCPA rights.

To exercise these rights, contact us at [dev@clkd.xyz](mailto\:dev@clkd.xyz).

### 12. Children's Privacy

The services are not intended for users under the age of 18. We do not knowingly collect personal data from children. If we become aware that we have collected data from a child, we will take steps to delete it promptly.

### 13. Email Notifications

If you provide a contact email — in-app or by subscribing to our newsletter or updates — we will send account, product, support, and related communications based on your consent. These communications may contain tracking pixels to measure open rates and engagement. You can remove your email at any time in Settings, unsubscribe via the link in any email, or contact us.

### 14. Changes to This Policy

We may update this Privacy Policy from time to time. Changes become effective upon posting to our website. Where changes are material, we will make reasonable efforts to notify you (e.g. via email or an in-app notice).

### 15. Contact Us

For questions or requests regarding this Privacy Policy, contact us at:

**Cloaked Technologies, Inc.**
[dev@clkd.xyz](mailto\:dev@clkd.xyz)


## Account Recovery

Cloaked is self-custodial — your funds are secured by cryptographic keys that only you hold. How you back up and recover those keys depends on how you registered.

### Passkey users

Your spending and viewing keys are derived from your passkey via a biometric prompt. The keys only exist in memory during active use and are never stored.

**Two layers of protection:**

#### 1. Keep your passkey synced

Your passkey is your primary access method. Make sure it's synced to a cloud-backed password manager (iCloud Keychain, Google Password Manager, 1Password, etc.) so it's available across devices. See [Passkey Safety](/docs/passkey-safety) for detailed instructions.

#### 2. Create a backup

A backup is a password-encrypted file containing your spending and viewing keys. If you lose your passkey, you can use the backup and your password to recover your funds at [recovery.clkd.xyz](https://recovery.clkd.xyz).

**How to create one:**

* **After registration** — you'll be prompted to create a backup immediately after setting up your passkey.
* **From Settings** — open the account menu, go to **Settings > Backup**, and follow the prompts. You'll verify with your passkey, then set a backup password.

**What the backup does:**

* Lets you recover your funds if you lose access to your passkey
* The backup file is encrypted with your chosen password (min 12 characters)
* Decryption and fund recovery happen at [recovery.clkd.xyz](https://recovery.clkd.xyz)

**What the backup does NOT do:**

* It does not reinstate a lost passkey — you would need to create a new passkey and re-register
* It does not give Cloaked access to your keys — the file is encrypted on your device before export

**Tips:**

* Store the backup file somewhere safe (cloud drive, USB, password manager)
* Use a strong, unique password and store it separately from the backup file
* You can create a new backup at any time from Settings

### Wallet + PIN users

Your spending and viewing keys are derived from a signature produced by your connected wallet, combined with your 4-digit PIN. Every time you authorize an action, Cloaked asks your wallet to sign a deterministic message (incorporating your PIN) and re-derives your keys from the result.

**What you need to back up:**

| What                                 | Why                                                                                                                                         |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **Wallet seed phrase / private key** | Your wallet produces the signature that derives your Cloaked keys. If you lose your wallet, you lose access.                                |
| **PIN**                              | The PIN is combined with your wallet address to construct the signing message. Without the correct PIN, the derived keys will be different. |

Cloaked does not store your PIN or your wallet's private key. Both must be backed up independently.

**Tips:**

* Follow your wallet provider's backup instructions (seed phrase, hardware wallet, etc.)
* Store your PIN securely — a password manager is a good option
* If you forget your PIN, there is no reset mechanism; your funds would only be recoverable if you can guess the correct 4-digit combination

### What if Cloaked goes offline?

Your funds remain safe onchain regardless of Cloaked's availability. You can always recover your keys independently and access your stealth addresses using the [recovery tool](https://recovery.clkd.xyz). See [FAQs](/docs/faq#what-happens-if-cloaked-goes-offline) for more details.

### Summary

|                    | Passkey                                        | Wallet + PIN                                |
| ------------------ | ---------------------------------------------- | ------------------------------------------- |
| **Primary access** | Passkey (biometric)                            | Wallet + PIN                                |
| **Backup method**  | Backup (encrypted file)                        | Wallet seed phrase + PIN                    |
| **Recovery tool**  | [recovery.clkd.xyz](https://recovery.clkd.xyz) | Re-connect wallet, enter PIN                |
| **Risk if lost**   | No passkey + no backup = permanent loss        | No wallet + no seed phrase = permanent loss |


## Safety & Bug Bounty

Cloaked's onchain account execution builds on Porto/Ithaca account contracts. Porto publishes its audit statement, bounty scope, and reporting process here:

[Porto Security & Bug Bounty](https://porto.sh/contracts/security-and-bug-bounty)


## Swaps & Bridging

Cloaked lets you swap tokens and bridge assets cross-chain directly from your stealth addresses, powered by [Uniswap](https://docs.uniswap.org/).

### How It Works

1. **Preview** — Enter a token pair and amount to see expected output, minimum received (after slippage), and estimated fees. No funds are locked.
2. **Quote** — Cloaked selects stealth addresses to fund the swap, locks those funds, and returns a time-limited quote.
3. **Confirm** — Sign with your passkey or wallet to submit the transaction.

### Supported Operations

| Operation         | Description                                                                |
| ----------------- | -------------------------------------------------------------------------- |
| **Swap**          | Exchange one token for another on the same chain (e.g. USDC → ETH on Base) |
| **Bridge**        | Move tokens across chains (e.g. ETH on Ethereum → ETH on Base)             |
| **Wrap / Unwrap** | Convert between ETH and WETH                                               |

### Fees

* **Network fee** — Covers gas for the swap. Varies by route complexity and gas prices. Like sends, fees can be paid in-kind (e.g. pay with USDC when swapping USDC → ETH).
* **Cloaked fee** — 0.85% of the input amount, included in the quoted price.

Both fees are displayed before you confirm.

### Slippage

Slippage is the difference between the quoted price and the execution price. Prices can move between when you submit and when the transaction confirms.

By default, Cloaked uses automatic slippage. The route provider calculates the lowest tolerance expected to execute successfully, and the quote returns the effective max slippage used for the transaction.

You can turn automatic slippage off and choose a manual tolerance up to 5%. Higher tolerance means the swap is more likely to succeed in volatile conditions but you may receive fewer tokens. Lower tolerance protects your price but the swap may fail if the market moves.

The **minimum received** amount in the quote reflects the effective slippage for the final quote.

### Bridging

When input and output tokens are on different chains, Cloaked automatically routes through a bridge (e.g. [Across](https://across.to/)). The same fees apply — network fee plus 0.85% Cloaked fee. The UI shows estimated fill time; bridge transactions may take a few minutes to arrive on the destination chain.


## Tagging & Deposit Reviews

Traditional wallets reuse one address, so your wallet slowly turns into a public financial profile.

Anyone who knows that address can inspect what came in, what stayed there, which apps you used, and where funds went next. Even someone you pay can look back at the address you paid from and see the rest of its history.

Cloaked changes the default by giving each receive a fresh address controlled by your account. One receive does not have to expose the rest of your wallet.

But fresh addresses only stay separate until they are used together. When you send, swap, bridge, or cash out, Cloaked defaults to using the addresses it needs to construct a transaction for the amount you chose. If an action uses several addresses, those addresses become linked onchain.

Deposit Review is the command center for managing that trade-off.

It highlights new inbound funds, lets you add private tags like `Payroll`, `Cold storage`, or `Ledger`, and helps you recognize what each balance represents before you spend or move it into Incognito.

Tags are a privacy-preserving way to keep granular control over your fresh-address funds.

### The Workflow

#### 1. Receive

New receives are highlighted in Cloaked. The Review page badge shows how many receives need attention, and the amber dot marks a specific receive that needs review.

<figure style={{ margin: '1.25rem auto 2rem', textAlign: 'center' }}>
  <img src="/deposit-review-icon.png" alt="Review page icon in Cloaked with one pending item" style={{ width: '112px', height: 'auto', display: 'block', margin: '0 auto' }} />

  <figcaption style={{ marginTop: '0.5rem', fontSize: '0.875rem', color: 'var(--vocs-color_text2)' }}>
    The Review page badge means there are receives waiting for review.
  </figcaption>
</figure>

<figure style={{ margin: '1.25rem auto 2rem', textAlign: 'center' }}>
  <img
    src="/deposit-review-activity.png"
    alt="Activity list showing received funds with amber review indicators"
    style={{
    width: '100%',
    maxWidth: '560px',
    display: 'block',
    margin: '0 auto',
    borderRadius: '8px',
    border: '1px solid var(--vocs-color_border)',
  }}
  />

  <figcaption style={{ marginTop: '0.5rem', fontSize: '0.875rem', color: 'var(--vocs-color_text2)' }}>
    A fresh receive can be separate onchain, but it still needs a decision from you.
  </figcaption>
</figure>

#### 2. Review Your Inbound

The Review page collects new inbound funds in one place. From there, you can add a tag, or if eligible, move funds directly into Incognito from the fresh address they landed at.

<figure style={{ margin: '1.25rem auto 2rem', textAlign: 'center' }}>
  <img
    src="/deposit-review-page.png"
    alt="Deposit Review page showing received assets that need review"
    style={{
    width: '100%',
    maxWidth: '420px',
    display: 'block',
    margin: '0 auto',
    borderRadius: '8px',
    border: '1px solid var(--vocs-color_border)',
  }}
  />

  <figcaption style={{ marginTop: '0.5rem', fontSize: '0.875rem', color: 'var(--vocs-color_text2)' }}>
    Review is the inbox for inbound funds.
  </figcaption>
</figure>

#### 3. Choose Funding Tags

When you take an action, Cloaked chooses the addresses needed to fund the amount. The **Select tags** button gives you more granular control before you approve.

<figure style={{ margin: '1.25rem auto 2rem', textAlign: 'center' }}>
  <img
    src="/deposit-review-send-select-tags.png"
    alt="Send form showing the Select tags button"
    style={{
    width: '100%',
    maxWidth: '520px',
    display: 'block',
    margin: '0 auto',
    borderRadius: '8px',
    border: '1px solid var(--vocs-color_border)',
  }}
  />

  <figcaption style={{ marginTop: '0.5rem', fontSize: '0.875rem', color: 'var(--vocs-color_text2)' }}>
    Select tags opens the funding controls for the action.
  </figcaption>
</figure>

Choose the tagged balances you are comfortable using for that action.

<figure style={{ margin: '1.25rem auto 2rem', textAlign: 'center' }}>
  <img
    src="/deposit-review-select-tags.png"
    alt="Select tags sheet showing balances tagged Salary and Cold storage"
    style={{
    width: '100%',
    maxWidth: '420px',
    display: 'block',
    margin: '0 auto',
    borderRadius: '8px',
    border: '1px solid var(--vocs-color_border)',
  }}
  />

  <figcaption style={{ marginTop: '0.5rem', fontSize: '0.875rem', color: 'var(--vocs-color_text2)' }}>
    Each balance lives at a different address. Selecting more than one can publicly link those
    addresses.
  </figcaption>
</figure>

#### 4. Approve Onchain Action With Context

Before you approve, Cloaked surfaces the tag being used for the transaction. This keeps the address-linking choice visible at the moment you sign.

<figure style={{ margin: '1.25rem auto 2rem', textAlign: 'center' }}>
  <img
    src="/deposit-review-bridge-tags.png"
    alt="Bridge review showing the Salary tag used for the transaction"
    style={{
    width: '100%',
    maxWidth: '420px',
    display: 'block',
    margin: '0 auto',
    borderRadius: '8px',
    border: '1px solid var(--vocs-color_border)',
  }}
  />

  <figcaption style={{ marginTop: '0.5rem', fontSize: '0.875rem', color: 'var(--vocs-color_text2)' }}>
    Tags stay visible before approval, so you know what source context you are using.
  </figcaption>
</figure>

#### 5. Understand Activity Later

After the transaction confirms, Activity keeps the associated tag visible. That gives you a running view of how your onchain footprint is forming over time.

<figure style={{ margin: '1.25rem auto 2rem', textAlign: 'center' }}>
  <img
    src="/deposit-review-activity-tagged.png"
    alt="Activity history showing a bridged transaction tagged Salary"
    style={{
    width: '100%',
    maxWidth: '560px',
    display: 'block',
    margin: '0 auto',
    borderRadius: '8px',
    border: '1px solid var(--vocs-color_border)',
  }}
  />

  <figcaption style={{ marginTop: '0.5rem', fontSize: '0.875rem', color: 'var(--vocs-color_text2)' }}>
    Activity shows the tags associated with completed actions.
  </figcaption>
</figure>

### Tags and Associations

Tags are not just a simple note on one deposit. Cloaked surfaces tags connected to a balance you hold when that connection can be proven.

That includes the receive address that directly funded a balance, and it can also include other tagged sources publicly associated with that balance. For example, addresses can become associated when they are used together in one action, when funds were previously combined, or when receives share the same address.

The goal is to show the onchain footprint around a balance, not just the first deposit that created it.

A tag is attached to the Cloaked receive address where funds originally landed. If several receives land at the same address, they share that tag because the chain already links them through that address.

When Cloaked can prove that current funds came from a tagged receive address, the tag can follow those funds through actions you take in Cloaked, such as sends, swaps, bridges, and cash-out flows. If you combine funds from two tagged sources, Cloaked can show both tags for that balance, helping you keep track.

For example:

1. Alice receives payroll at one fresh address and tags it `Payroll`.
2. She receives funds from Cold storage at another fresh address and tags it `Ledger`.
3. If she spends from only the payroll address, Cloaked can show that source as `Payroll`.
4. If she spends from both addresses together, those sources are now linked by that transaction, so Cloaked can show `Payroll + Ledger`.

### Tag Privacy

Tag names are encrypted before they are saved. The readable text stays protected by keys from your Cloaked account. The server stores encrypted tag data, not the readable tag.

Cloaked can still see the addresses, transactions, and encrypted tag records it stores for your account. The private part is the tag text itself.

You can clear or edit a tag later. Editing a tag updates the tag for that receive address, not for one individual token row.

### Review States

**Needs review** means Cloaked found new received funds that can be tagged but do not have a user tag yet. This is the normal first state for a new fresh receive.

**In progress** means an Incognito deposit is underway, waiting for approval, or needs attention after a rejection. Until that process finishes or funds are recovered, the review item stays active.

**Done** means the receive has been tagged or the Incognito deposit has been approved. Older tagged receives may also appear as done so you can still see their tags in context.

### Incognito Tags

Cloaked may show an `Incognito receive` tag when funds came out of a supported privacy pool. It means those funds do not carry visible onchain history back to your Cloaked account's fresh receive addresses.

<figure style={{ margin: '1.25rem auto 2rem', textAlign: 'center' }}>
  <img
    src="/deposit-review-incognito-tag.png"
    alt="Balance row showing an Incognito receive tag"
    style={{
    width: '100%',
    maxWidth: '520px',
    display: 'block',
    margin: '0 auto',
    borderRadius: '8px',
    border: '1px solid var(--vocs-color_border)',
  }}
  />

  <figcaption style={{ marginTop: '0.5rem', fontSize: '0.875rem', color: 'var(--vocs-color_text2)' }}>
    Incognito receive means the funds came out of a supported privacy pool.
  </figcaption>
</figure>

Cloaked carries the `Incognito receive` tag forward as long as those funds are not associated with any other visible history. If you receive Incognito funds and then swap them, the tag can stay with the swapped balance.

If you later send those funds together with funds from a different source, that action links the sources. At that point, Cloaked stops treating the whole balance as an Incognito receive, and the tag drops away.

### Depositing Into Incognito and Tags

This is separate from the `Incognito receive` tag. It is about what happens to tags you added before funds enter Incognito.

Depositing into Incognito creates a privacy boundary. The privacy pool breaks the visible onchain history between the address that entered the pool and the funds that later come out. Earlier address tags do not carry through the pool because that link is no longer visible onchain.

### What Tags Are Not

Tags are for your own wallet control. They are not public claims.

Tags do not:

* make tag names public;
* prove what a tag means to anyone else;
* change what already happened onchain;
* stop public blockchains from showing transactions and balances.

If you spend from several receive addresses in one transaction, those addresses become linked onchain. Tags make that easier to see before and after it happens, but they do not erase the link.

### How It Fits

Fresh receives start with address separation. Deposit Review helps you decide what happens next.

Use tags when you want to keep fresh-address funds understandable. Use Incognito when eligible funds should move through a privacy pool before later spending. Together, they make the receive workflow easier to manage without creating a new wallet every time you want a fresh start.

See [Privacy Pools](/docs/privacy-pools) for how Incognito balances work.


## Terms of Service

**Last Updated:** May 1, 2026

***

### 1. Scope

Cloaked Technologies, Inc. ("Cloaked", "we", "us") offers services through clkd.xyz, app.clkd.xyz, recovery.clkd.xyz, api.clkd.xyz, clkd.id, and related domains. By accessing or using any Cloaked service, you agree to be bound by these Terms. If you do not agree, you must stop using the services immediately.

### 2. Services

Cloaked provides a non-custodial wallet application and developer infrastructure for stealth address payments on supported EVM-compatible networks. Our services include:

* Sending and receiving tokens via stealth addresses
* Transaction relay — submitting signed transactions to blockchain networks on your behalf
* Stealth address generation, scanning, and balance tracking
* Address selection controls
* Passkey-based (WebAuthn / PRF) and PIN-based authentication
* Token swaps and cross-chain bridges via third-party protocols (e.g. Uniswap)
* Off-ramp features — selling crypto for fiat through third-party peer-to-peer escrow interfaces and protocols, including [Peer](https://www.peer.xyz/)
* Privacy pool deposits and withdrawals via third-party protocols (e.g. 0xbow Privacy Pools)
* ENS subdomain registration and management
* Encrypted backup generation
* Developer APIs for stealth address integration

Your funds and access keys are self-custodial — only you can access and control them. Automated or bot-driven account creation is prohibited. You are responsible for securing your account credentials and all activity conducted through your account. You must be at least 18 years old to use the services.

### 3. Rights and Obligations of Cloaked

We provide the services using reasonable care and skill and maintain our infrastructure free from known malicious software. We perform regular maintenance but do not guarantee that the services are error-free or available without interruption.

We may suspend or restrict access to specific accounts if we reasonably suspect illegal or fraudulent activity, or if required by applicable law. Because we do not collect personally identifiable information, restrictions apply to accounts, not individuals.

We reserve the right to modify these Terms and the services. Where reasonably possible, we will notify you of material changes before they take effect.

**Cloaked explicitly does not:**

* Offer custody of your funds or access to your private keys
* Provide key recovery services (recovery is your responsibility via your backup)
* Verify, endorse, or guarantee any transaction
* Provide financial, investment, accounting, tax, or legal advice
* Engage in regulated financial activities

### 4. Rights and Obligations of the User

You must comply with all applicable laws and regulations when using the services. You may not:

* Circumvent or attempt to bypass any security or access controls
* Use the services for any unlawful purpose, including money laundering, terrorist financing, or sanctions evasion
* Access the services via automated systems, bots, or scrapers without our written permission
* Reverse engineer, decompile, or derive the source code of any proprietary part of the services
* Engage in data mining or data harvesting of non-public service data
* Sublicense, resell, or redistribute the services without written permission
* Interfere with the services or other users' use of the services

You acknowledge the inherent risks of blockchain technology, including but not limited to smart contract vulnerabilities, network congestion, and potential complete loss of funds.

### 5. User Representations

By using the services, you represent and warrant that you:

* Are not subject to economic or trade sanctions administered or enforced by the United States, including those maintained by the Office of Foreign Assets Control (OFAC), or any other applicable jurisdiction
* Are not located in, organized in, or ordinarily resident in any jurisdiction subject to comprehensive economic or trade sanctions under applicable law
* Have fully read and understood these Terms
* Are of legal age in your jurisdiction and have the capacity to enter into a binding agreement

### 6. Non-Custodial Nature

Cloaked is a non-custodial service. We never hold, control, or have access to your private keys or spending capability. The spending capability never leaves your device. Transactions are executed on-chain and are irreversible once confirmed.

You are solely responsible for:

* Securing your passkeys, PIN, and backup
* Verifying all transaction details before signing
* Maintaining copies of your backup in a safe location

Lost passkeys or backups may result in permanent, irrecoverable loss of access to your funds. We cannot recover your account or funds.

### 7. Supported Networks and Tokens

The services currently operate on supported EVM-compatible networks. Network and token availability may change without notice. We do not endorse any specific token or project.

### 8. Swaps and Bridges

Token swaps and cross-chain bridges are routed through third-party protocols (e.g. Uniswap). Slippage, price impact, and third-party protocol fees apply. Cloaked charges a service fee on swaps and bridges (currently 0.85%), which is disclosed before transaction execution and may be updated from time to time. We do not guarantee swap or bridge execution, pricing, or availability.

### 8A. Off-Ramp Services

Cloaked integrates third-party peer-to-peer escrow interfaces and protocols (including [Peer](https://www.peer.xyz/), operated by P2P Labs Inc.) that allow you to sell crypto for fiat through peer-to-peer escrow flows. Off-ramp features are subject to the following:

* **Third-party provider.** Peer-to-peer off-ramp flows, payment proof, verification, and escrow settlement are provided by third parties, not by Cloaked. Peer provides an app and interface for accessing a peer-to-peer escrow protocol; the interface is distinct from the protocol, and Cloaked does not control Peer, buyers, fiat payment platforms, payment proof review, trade execution on the protocol, or third-party escrow contracts. Use of off-ramp features may be subject to Peer's [Terms of Service](https://www.peer.xyz/tos), Peer's [Privacy Policy](https://www.peer.xyz/pp), and the terms and policies of the selected payment platform.
* **Peer-to-peer payments.** A cash-out order may be filled by one or more third-party buyers who send fiat through the selected payment method. Cloaked does not send the fiat payment, custody fiat funds, operate the fiat payment platform, or guarantee buyer performance.
* **Payment details.** You are responsible for entering accurate payment destination information, including any payment handles or similar identifiers, and selecting a payment method you are legally permitted to use. Payment identifiers may be processed by Peer and made available as needed for buyers to complete payment. Incorrect, unavailable, suspended, or restricted payment accounts may delay or prevent settlement.
* **Availability and completion.** Off-ramp availability depends on third-party liquidity, buyer activity, supported payment methods, supported jurisdictions, network conditions, and third-party service availability. Quotes, estimated fiat amounts, fill times, and conversion rates are estimates only and are not guaranteed.
* **Cancellations and recovery.** Off-ramp orders may be cancellable or recoverable depending on escrow state and buyer activity. Funds locked in an active buyer intent may not be immediately recoverable and may require expiration or additional recovery steps.
* **Third-party and smart contract risk.** Off-ramp flows may use smart contracts, swaps, bridges, third-party payment systems, wallets, and proof-generation or verification systems. You acknowledge the risk of delay, failed execution, partial fills, payment disputes, inaccurate or misleading information from counterparties, smart contract vulnerabilities, payment platform limitations, and partial or total loss.
* **Compliance and taxes.** You are solely responsible for complying with laws and regulations that apply to your use of off-ramp features, including sanctions restrictions, payment platform rules, reporting obligations, and any tax consequences of selling crypto for fiat.
* **Fees.** Off-ramp transactions may include network fees, route costs, third-party fees, and Cloaked service fees. Applicable fees and estimated proceeds are disclosed before transaction execution.

### 8B. Privacy Pools

Cloaked integrates third-party privacy pool protocols (e.g. 0xbow Privacy Pools) that allow you to deposit funds into on-chain smart contracts and later withdraw or spend from those deposits. Privacy pool features are subject to the following:

* **Third-party protocol.** Privacy pools are operated by third parties, not by Cloaked. Cloaked does not control the privacy pool smart contracts, the Association Set Provider (ASP), or the compliance approval process. Use of privacy pools is subject to the terms and policies of the respective protocol operators.
* **No privacy guarantee.** Privacy pool features are designed to reduce the traceability of on-chain transactions but do not guarantee anonymity or privacy. The degree of privacy depends on factors outside Cloaked's control, including pool size, the number of participants, on-chain analysis techniques, and the behavior of third-party protocol operators. Cloaked makes no representation or warranty regarding the effectiveness of any privacy feature.
* **User behavior.** You have total control over your funds. Your actions before or after using privacy pool features may reduce or eliminate any privacy benefits. For example, depositing and withdrawing similar amounts in close succession, reusing addresses, or publicly associating your identity with wallet addresses can allow third parties to link your activity. Cloaked has no control over how you use your funds and is not responsible for any loss of privacy resulting from your own actions.
* **Relay visibility.** Because Cloaked's relay service submits both deposit and withdrawal transactions on your behalf, Cloaked can observe the association between your deposits and withdrawals. Users who require that Cloaked not have this visibility may interact with privacy pool contracts independently using their exported keys.
* **ASP approval.** Deposits into privacy pools require approval by an ASP. Approval is not guaranteed and is determined solely by the ASP operator. Cloaked is not responsible for deposits that are declined or delayed by the ASP.
* **Smart contract risk.** Privacy pool smart contracts are developed and maintained by third parties. Cloaked does not audit, endorse, or guarantee the security or correctness of these contracts. You acknowledge that depositing funds into a privacy pool carries the risk of partial or total loss due to smart contract vulnerabilities, bugs, or exploits.
* **Fees.** Privacy pool deposits are subject to an on-chain vetting fee charged by the pool protocol and a Cloaked service fee. Both fees are disclosed before transaction execution. The Cloaked service fee may be waived for certain users.

### 9. Transaction Relay

Cloaked operates a transaction relay service that submits your signed transactions to blockchain networks on your behalf. The relay transmits transactions you have already authorized and signed on your device — Cloaked cannot initiate, modify, or reverse transactions on your behalf.

* **Best-effort delivery.** We use commercially reasonable efforts to relay transactions promptly but do not guarantee that any transaction will be included in a block, confirmed, or executed. Transactions may fail, be delayed, or be dropped due to network conditions, gas pricing, or other factors outside our control. Cloaked is not liable for any loss arising from unconfirmed or failed transactions.
* **Fee guarantee.** The network fee quoted before transaction approval is a conservative estimate that serves as the maximum you will be charged. At relay time, Cloaked recalculates the fee based on current network conditions and reduces your payment accordingly; actual charges are typically lower than the quoted maximum. Gas estimation is inherently imprecise — estimates may exceed the actual network cost incurred, and Cloaked may retain the difference. If actual network costs exceed the quoted maximum, Cloaked absorbs the difference.
* **Availability and refusal.** The relay service may be temporarily unavailable due to maintenance or network issues. Cloaked reserves the right to refuse to relay any transaction that we reasonably believe may violate applicable law or these Terms.

### 10. Fees

* Network (gas) fees are paid by the user for all on-chain transactions (sends, swaps, etc.). The network fee displayed before transaction approval is a conservative estimate that represents the maximum amount you will be charged. Actual charges are typically lower due to relay-time fee adjustment based on current network conditions
* Third-party protocol fees (e.g. Uniswap) are determined by those protocols
* Cloaked charges service fees on swaps, bridges, privacy pool deposits, and off-ramps. Fee rates vary by transaction type, are disclosed before transaction execution, and are subject to change. Off-ramp quotes may also include third-party fees, route costs, or estimated fiat conversion amounts. No separate service fee is charged on sends; however, network fee estimates include an operational buffer to account for gas estimation variance, and Cloaked may retain the difference between estimated and actual network costs
* All fees are disclosed before transaction execution
* On-chain gas market conditions may cause any transaction to fail; failed or reverted transactions may still incur gas fees
* Except where prohibited by law, all fees are non-refundable

### 11. API Usage

Access to Cloaked's APIs requires an API key issued by Cloaked. By using our APIs, you agree to the following:

* API keys are issued at our sole discretion and are non-transferable. You may not share, publish, or embed your API key in client-side code or publicly accessible repositories.
* All API endpoints are subject to rate limits. You must not attempt to circumvent, exceed, or abuse these limits.
* We reserve the right to revoke, suspend, or restrict any API key at any time, for any reason, including but not limited to suspected abuse, violations of these Terms, or excessive usage.
* You are responsible for all activity that occurs under your API key and for ensuring that your integration complies with these Terms and all applicable laws.
* If you build products or services that use Cloaked's APIs, you are responsible for your end-users' compliance with these Terms. You must not use the APIs to facilitate activity that would violate these Terms if performed directly.
* We may modify, deprecate, or discontinue API endpoints at any time. Where reasonably possible, we will provide advance notice of breaking changes.
* API availability is provided on an "as is" basis. We do not guarantee uptime, latency, or throughput for any API endpoint.

### 12. Termination

Either party may terminate the relationship at any time. You may stop using the services at any time. We may suspend or terminate your access for violations of these Terms.

Due to the non-custodial nature of the service, your funds remain accessible on-chain regardless of termination. You can always access your stealth addresses using your backup and our open-source tools.

Termination does not affect any rights or obligations that have accrued prior to termination.

### 13. Intellectual Property

All intellectual property rights in the services remain with Cloaked. Open-source components are governed by their respective licenses. Cloaked owns the clkd.eth ENS domain and all subdomains issued under it. We reserve the right to revoke, suspend, or discontinue any subdomain at any time, including if the associated account violates these Terms.

### 14. Disclaimers

The services are provided "as is" and "as available" without warranties of any kind, whether express or implied, including but not limited to implied warranties of merchantability, fitness for a particular purpose, and non-infringement.

We do not warrant that:

* The services will be uninterrupted, timely, secure, or error-free
* Blockchain networks will be available or function correctly
* Any information provided through the services is accurate or complete

Nothing in the services constitutes financial, investment, tax, or legal advice.

Nothing in the services constitutes a guarantee of privacy, anonymity, or untraceability. Privacy features, including privacy pools, are provided on a best-effort basis and may not prevent all forms of transaction analysis or identification.

Manual address selection controls are wallet management features. They may help you control which address-held funds are used together, but they do not alter public blockchain data or guarantee that activity cannot be linked.

### 15. Limitation of Liability

To the maximum extent permitted by applicable law, Cloaked is liable only for damages caused by gross negligence or willful misconduct. Neither party may recover any amount with respect to loss of profit, data, goodwill, or other indirect, incidental, consequential, or punitive damages.

This includes, without limitation, losses arising from:

* Failed, delayed, or misdirected transactions, including those submitted via the relay service
* Smart contract bugs or vulnerabilities
* Blockchain network outages or reorganizations
* Third-party protocol failures (e.g. Uniswap, bridge providers)
* Off-ramp failures, delays, payment disputes, partial fills, buyer non-performance, payment platform restrictions, or errors by third-party peer-to-peer escrow services or interfaces such as Peer
* Privacy pool deposits that are declined, delayed, or lost, including due to ASP decisions or third-party smart contract failures
* Any loss of privacy or anonymity, whether resulting from on-chain analysis, user behavior, relay visibility, or any other cause
* Loss of access due to lost passkeys or backups

Force majeure events (including but not limited to natural disasters, war, pandemic, government action, or blockchain network failures) exempt performance obligations.

### 16. Indemnification

You agree to indemnify, defend, and hold harmless Cloaked and its officers, directors, employees, and agents from and against any claims, damages, losses, liabilities, costs, and expenses arising from your use of the services or violation of these Terms.

### 17. Privacy

Your use of the services is also governed by our [Privacy Policy](/docs/privacy), which describes how we collect, use, and protect your information.

### 18. Governing Law and Dispute Resolution

These Terms are governed by and construed in accordance with the laws of the State of Delaware, United States, without regard to its conflict of laws principles.

**Mandatory Arbitration.** Any dispute, claim, or controversy arising out of or relating to these Terms or the services ("Dispute") shall be resolved exclusively by binding arbitration administered by the American Arbitration Association (AAA) under its Commercial Arbitration Rules. The arbitration shall be conducted by a single arbitrator in Wilmington, Delaware. The arbitrator's decision shall be final and binding and may be entered as a judgment in any court of competent jurisdiction.

**Class Action Waiver.** You agree that any Dispute shall be brought in your individual capacity only, and not as a plaintiff or class member in any purported class, consolidated, or representative action. The arbitrator may not consolidate more than one person's claims and may not preside over any form of class or representative proceeding.

**Exceptions.** Either party may seek injunctive or other equitable relief in any court of competent jurisdiction to prevent the actual or threatened infringement of intellectual property rights. Claims eligible for small claims court in Delaware may be brought there instead of arbitration.

**Opt-Out.** You may opt out of this arbitration and class action waiver provision by sending written notice to [dev@clkd.xyz](mailto\:dev@clkd.xyz) within 30 days of first accepting these Terms. If you opt out, Disputes shall be subject to the exclusive jurisdiction of the state and federal courts located in Delaware.

### 19. Miscellaneous

* If any provision of these Terms is found to be unenforceable, the remaining provisions continue in full force and effect.
* You may not assign your rights or obligations under these Terms without our prior written consent.
* These Terms constitute the entire agreement between you and Cloaked regarding the services.
* Our failure to enforce any right or provision does not constitute a waiver of that right or provision.
* Links to third-party websites or services do not imply endorsement or responsibility for their content or practices.

### 20. Contact

For questions about these Terms, contact us at [dev@clkd.xyz](mailto\:dev@clkd.xyz).


## Using Cloaked

import { APP_URL } from '../../lib/constants';

Cloaked is a self-custodial wallet for fresh receive addresses and controlled sends.

Cloaked lets you receive funds at new addresses, see them in one wallet, and decide later which address-held balances should be used together. You always retain direct control of your funds.

* **Web app** — The primary Cloaked client. Register with a passkey or existing wallet, then send and receive with fresh stealth addresses from any browser.
* **API** — Programmatic access for server-to-server integrations, agents, and automated operations.
* **Farcaster mini-app** — Use Cloaked directly inside Farcaster, where onchain balances are publicly visible.

<a
  href={APP_URL}
  target="_blank"
  rel="noopener noreferrer"
  style={{
  display: 'inline-block',
  marginTop: '1rem',
  marginBottom: '2rem',
  padding: '12px 24px',
  borderRadius: '8px',
  fontSize: '14px',
  fontWeight: 600,
  fontFamily: "'Nunito', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif",
  background: '#7B4DFF',
  color: 'white',
  textDecoration: 'none',
  transition: 'background-color 0.2s ease',
}}
  onMouseEnter={(e) => {
  e.currentTarget.style.backgroundColor = '#6B3DEF';
}}
  onMouseLeave={(e) => {
  e.currentTarget.style.backgroundColor = '#7B4DFF';
}}
>
  Open Cloaked App ↗
</a>

### Registration

Registration takes three steps:

1. **Create a passkey or connect a wallet** — A biometric prompt (Face ID, fingerprint, or Windows Hello) creates a passkey bound to Cloaked. Alternatively, you can connect an existing wallet (MetaMask, Rabby, etc.) and sign a message. Either way, this produces the secret used to derive your stealth address keys. See [Authentication Methods](/docs/developers#authentication-methods) for more on supported options.
2. **Authenticate** — Cloaked performs [Sign-In with Ethereum](https://login.xyz/) (SIWE) using an address derived from your private spending key. This happens automatically — your identity and your original passkey or wallet address are never sent to the server.
3. **Choose your ENS subdomain** — Pick a unique subdomain (e.g. `username.clkd.eth`) that others will use to send you funds.

### Receiving Funds

Each time someone sends funds to the `username.clkd.eth` name Cloaked gives you, or to a custom ENS name you linked to Cloaked, Cloaked can generate a fresh stealth address for that payment.

You can also share a direct payment page at `<username>.clkd.id` when you want a QR-code page. Developers can generate payment addresses through the API.

<figure style={{ textAlign: 'center', margin: '2rem auto', display: 'block' }}>
  <img
    src="/receive-funds-ui.png"
    alt="Receiving funds interface showing QR code and address"
    style={{
    maxWidth: '300px',
    display: 'block',
    margin: '0 auto',
    border: '1px solid var(--vocs-color_border)',
    borderRadius: '8px',
  }}
  />

  <figcaption style={{ marginTop: '0.5rem', fontSize: '0.875rem', color: 'var(--vocs-color_text2)' }}>
    Example of the shareable payment page for `satoshi.clkd.id`
  </figcaption>
</figure>

Your aggregated balance across all generated addresses is displayed automatically, so you always have a single view of your total funds.

### Sending Funds

To send funds:

1. **Enter amount and destination** — Select the asset and chain, enter the amount, and provide the destination address.
2. **Choose sources if needed** — By default, Cloaked selects address-held balances automatically. Where Advanced Control is enabled, you can choose exact addresses before quoting.
3. **Review the quote** — Cloaked selects enough address-held funds to cover the amount, calculates the required fees, and routes any change to a new stealth address.
4. **Confirm** — Authenticate with your passkey (biometric prompt) or wallet to sign the transaction.
5. **Transaction submitted** — Once signed, the transaction is relayed onchain.

### Fees

Cloaked calculates transaction fees that include onchain gas costs. Fees are automatically calculated and displayed before you confirm any transaction, so you always know what you'll pay upfront.

#### How Fees Work

Fees include the cost of executing transactions on the blockchain. Cloaked uses [Porto](https://porto.sh/) smart accounts, which require gas to execute actions.

Fees can be paid in-kind. For example, if you're sending an ERC20 token and your account doesn't have ETH, the token itself can be used to pay the transaction fee. This makes it easier to send tokens without needing to maintain a separate ETH balance for gas.

#### Transaction Complexity

When you send funds, Cloaked may need to combine balances from multiple stealth addresses. Transactions that require combining funds from more addresses will have higher fees due to the additional onchain operations needed. Cloaked automatically optimizes the selection of addresses to minimize fees while ensuring you have sufficient funds to cover both the send amount and fees.

Any leftover funds after covering the send amount and fees are automatically routed to a new stealth address. This avoids reusing the sending address for change.

Combining addresses is visible onchain. If you spend from several receive addresses in one transaction, those addresses become linked by that transaction. Advanced Control is meant to make that trade-off visible before you sign.

#### What You See

Before confirming any transaction, Cloaked shows you a quote that includes:

* **Send amount** — The amount you're sending to the destination
* **Fee** — The estimated transaction fee
* **Total required** — Send amount + fee

This gives you full transparency into the costs before you commit to the transaction.

### API

Cloaked exposes a REST API for programmatic access to stealth address payments, including generating payment addresses, fetching quotes, and sending transactions.

This is useful for server-to-server integrations, autonomous agents, and automated operations. See the [API Reference](/docs/api-reference) for endpoints and the [Developers](/docs/developers) page for details on API keys, team accounts, and authentication.

### Farcaster Mini App

Cloaked is also available as a Farcaster mini-app. Crypto social platforms associate usernames and social graphs with onchain addresses, making balances and transaction history easy to inspect. The mini-app gives you the same stealth address privacy, accessible directly within Farcaster.