# Polygon Developer Docs ## Docs - [Get bearer token](https://docs.polygon.technology/api-reference/auth/get-bearer-token.md): Exchanges an OMS API key + secret for a bearer token valid for 60 minutes. The token is signed by the OMS issuer and must be presented as `Authorization Bearer ` on every other endpoint. - [Create a cash-in deposit code](https://docs.polygon.technology/api-reference/cashins/create-a-cash-in-deposit-code.md): Creates a cash-in: reserves a deposit code the customer presents at a physical cash location to deposit fiat, which is then converted to crypto and credited to the destination wallet. The 201 response includes the cash-in and its deposit instructions (the code and its expiry). Pass an Idempotency-Ke… - [Get a cash-in by ID](https://docs.polygon.technology/api-reference/cashins/get-a-cash-in-by-id.md): Retrieves a single cash-in by ID, including its current status and sub-status, source and destination amounts, fees, and deposit instructions. - [List cash-ins](https://docs.polygon.technology/api-reference/cashins/list-cash-ins.md): Returns a paginated list of cash-ins, optionally filtered by customer, status, type, date range, or free-text search. Results are ordered newest-first. Date filters `createdAfter` and `createdBefore` are inclusive, matching `GET /transactions`. - [Refresh a cash-in deposit code](https://docs.polygon.technology/api-reference/cashins/refresh-a-cash-in-deposit-code.md): Regenerates the deposit code for an existing cash-in whose code has expired or is close to expiring, returning a fresh code and expiry. Pass an Idempotency-Key header to safely retry. - [List cash locations](https://docs.polygon.technology/api-reference/cashlocation/list-cash-locations.md): Returns cash pickup and deposit locations for the given provider within range of the supplied coordinates, each with its distance from that point. Use the flow parameter to select the cash-in or cash-out provider configuration. - [Get customer balance](https://docs.polygon.technology/api-reference/customer/get-customer-balance.md): Get the aggregated estimated balance across all customer wallets/assets. - [List transactions for a customer](https://docs.polygon.technology/api-reference/customer/list-transactions-for-a-customer.md): List transactions for a customer. See `GET /transactions` for the ordering, limit bounds, inclusive date-filter semantics, and cursor pagination contract - all identical here but scoped to the customer. - [Create a customer](https://docs.polygon.technology/api-reference/customers/create-a-customer.md) - [Delete a customer](https://docs.polygon.technology/api-reference/customers/delete-a-customer.md): Soft delete. Sets status to inactive. Inactive customers cannot create new transactions but data is retained for compliance purposes. - [Get customer by ID](https://docs.polygon.technology/api-reference/customers/get-customer-by-id.md): Returns the customer with their wallets included in the response. - [List customers](https://docs.polygon.technology/api-reference/customers/list-customers.md): Returns a paginated list of customers under the current Project. - [Update a customer](https://docs.polygon.technology/api-reference/customers/update-a-customer.md): Partial update. Only include fields you want to change. Compliance-relevant changes (residentialAddress, lastName, identifyingInformation, ipAddress) may trigger endorsement re-evaluation. Including endorsement names in the endorsements array explicitly triggers re-evaluation. - [Bulk payouts](https://docs.polygon.technology/api-reference/guide-b2b-payouts.md): Disburse stablecoin or fiat payments to multiple recipients from a platform treasury wallet. - [Bank transfers](https://docs.polygon.technology/api-reference/guide-bank-transfers.md): How to move money between bank accounts and OMS wallets in both directions. - [Cash-in](https://docs.polygon.technology/api-reference/guide-cash-in.md): How to let a customer deposit physical cash at a retail location and receive USDC in their wallet. - [Cash pickup](https://docs.polygon.technology/api-reference/guide-cash-pickup.md): Let a customer withdraw crypto as physical cash at a retail or ATM location. - [Global remittance](https://docs.polygon.technology/api-reference/guide-global-remittance.md): Cross-border money transfer: fiat in, stablecoin settlement on Polygon, fiat out. - [Open Money Stack API](https://docs.polygon.technology/api-reference/overview.md): How the Open Money Stack API works: core concepts, transaction types, and API structure. - [Create a payment quote](https://docs.polygon.technology/api-reference/quote/create-a-payment-quote.md): Creates a payment quote with a locked exchange rate and fee breakdown for a prospective transfer. Quotes expire after a short window; reference the returned quote ID when executing the transaction. Pass an Idempotency-Key header to safely retry. - [Get quote by ID](https://docs.polygon.technology/api-reference/quote/get-quote-by-id.md): Retrieves a previously created quote by ID, including its locked rate, fee breakdown, and expiry. - [Simulate cash-in auth commit](https://docs.polygon.technology/api-reference/sandbox/simulate-cash-in-auth-commit.md): Commit a previously-authorized simulated cash-in transaction (sandbox only). - [Simulate cash-in auth void](https://docs.polygon.technology/api-reference/sandbox/simulate-cash-in-auth-void.md): Void a previously-authorized simulated cash-in transaction (sandbox only). - [Simulate cash-in barcode auth](https://docs.polygon.technology/api-reference/sandbox/simulate-cash-in-barcode-auth.md): Authorize a barcode load against the simulated cash-in flow (sandbox only). - [Simulate inbound transfer on a Deposit Address](https://docs.polygon.technology/api-reference/simulation/simulate-inbound-transfer-on-a-deposit-address.md): Simulate an inbound stablecoin (blockchain) transfer against a Deposit Address, for testing webhook and reconciliation flows. Sandbox / non-production only; returns 404 in production-live. The amount currency and network are resolved server-side from the Deposit Address; the response fields are docu… - [Simulate inbound transfer on a Virtual Account](https://docs.polygon.technology/api-reference/simulation/simulate-inbound-transfer-on-a-virtual-account.md): Simulate an inbound fiat transfer against a Virtual Account, for testing webhook and reconciliation flows. Sandbox / non-production only; returns 404 in production-live. Set the `rail` field in the request body to choose the transfer type (`ach_in`, `wire_in`, or `swift_in`); the request and respons… - [Execute a transaction (send)](https://docs.polygon.technology/api-reference/transaction/execute-a-transaction-send.md): Executes a transfer by accepting an open quote. Reference the quote by its ID; OMS pulls funds from the quote's source and delivers them to its destination. Pass an Idempotency-Key header to safely retry without sending twice. - [Get transaction by ID](https://docs.polygon.technology/api-reference/transaction/get-transaction-by-id.md): Retrieves a single transaction by ID. Optionally pass senderCustomerId or recipientCustomerId to set which customer perspective the role field reflects. - [List transactions with filters](https://docs.polygon.technology/api-reference/transaction/list-transactions-with-filters.md): List transactions with filters. - [Create a new wallet asset for a customer](https://docs.polygon.technology/api-reference/wallet/create-a-new-wallet-asset-for-a-customer.md): Provisions a crypto wallet for a customer for the requested asset and chain, returning the created wallet. Pass an Idempotency-Key header to safely retry without provisioning duplicates. - [Get current balance of a specific wallet](https://docs.polygon.technology/api-reference/wallet/get-current-balance-of-a-specific-wallet.md): Returns the current balance of a specific wallet, including the display balance and its estimated value in the currency requested via `estimatedBalanceCurrencyCode` (defaults to USD). - [List customer wallets](https://docs.polygon.technology/api-reference/wallet/list-customer-wallets.md): Lists the crypto wallets provisioned for a customer (one per asset/chain), with cursor-based pagination. Returns an empty list if none have been provisioned yet. - [List wallet transactions](https://docs.polygon.technology/api-reference/wallet/list-wallet-transactions.md): Returns the transaction history for the specified wallet, most recent first, with cursor-based pagination and optional type/date filters. - [Create a webhook](https://docs.polygon.technology/api-reference/webhook/create-a-webhook.md): Registers a new HTTPS endpoint to receive event deliveries. OMS generates a signing secret (`whsec_` prefix) that is returned **once** in this response and never again - store it in your secrets manager immediately. The endpoint starts receiving deliveries immediately after creation. - [Delete a webhook](https://docs.polygon.technology/api-reference/webhook/delete-a-webhook.md): Permanently removes a webhook endpoint. Any in-flight or queued deliveries for this endpoint are abandoned. There is no soft-delete - use `enabled: false` if you want to pause deliveries temporarily. - [Get a webhook](https://docs.polygon.technology/api-reference/webhook/get-a-webhook.md): Returns a single webhook endpoint by its `whk_`-prefixed ID. The `secret` field is never included - use the value stored at creation time. - [List webhooks](https://docs.polygon.technology/api-reference/webhook/list-webhooks.md): Returns a paginated list of all webhook endpoints registered for your organization. The `secret` field is never included in list responses. Supports cursor-based pagination via `limit` (default 10, max 100), `startingAfter` (cursor for the next page), and `endingBefore` (cursor for the previous page… - [Update a webhook](https://docs.polygon.technology/api-reference/webhook/update-a-webhook.md): Partially updates a webhook. All fields are optional - only supplied fields are modified. To pause deliveries without deleting the endpoint, set `enabled` to `false`. To resume, set it back to `true`. The `secret` is not returned in update responses. - [Polygon CDK FAQs](https://docs.polygon.technology/chain-development/cdk/additional-resources/faqs.md): Frequently asked questions about Polygon CDK, covering execution clients, rollup modes, and Agglayer integration. - [Glossary](https://docs.polygon.technology/chain-development/cdk/additional-resources/glossary.md): Definitions of technical terms used throughout the Polygon CDK documentation. - [Deployment Modes](https://docs.polygon.technology/chain-development/cdk/cdk-opgeth/architecture.md): Component reference for the three CDK deployment modes: sovereign, validium, and zkrollup. - [Devnet Deployment Guide](https://docs.polygon.technology/chain-development/cdk/cdk-opgeth/devnet-deployment-guide.md): How to deploy a production-like Pessimistic Proof (cdk-opgeth-sovereign) devnet. - [Going to Production](https://docs.polygon.technology/chain-development/cdk/cdk-opgeth/going-to-production.md): Deploy a CDK chain to testnet or mainnet with support from implementation providers. - [Quickstart](https://docs.polygon.technology/chain-development/cdk/cdk-opgeth/local-guide.md): How to deploy a local cdk-opgeth testnet using Kurtosis, including L1, L2, Agglayer, and OP Stack components. - [Why Choose CDK?](https://docs.polygon.technology/chain-development/cdk/get-started/benefits.md): Key benefits of Polygon CDK, including EVM compatibility, Agglayer integration, rollup modes, and implementation support. - [What is CDK?](https://docs.polygon.technology/chain-development/cdk/get-started/overview.md): Enterprise-grade toolkit for building custom Ethereum L2 chains. Agglayer interoperability is built in by default. - [Polygon CDK: private blockchains with public liquidity](https://docs.polygon.technology/chain-development/cdk/index.md): Polygon CDK lets institutions launch their own private blockchain with built-in Agglayer connectivity. Privacy as a spectrum (private validium, gated access, sovereign), 20,000+ TPS, and a bespoke chain operated with Polygon. - [Privacy Configuration](https://docs.polygon.technology/chain-development/cdk/privacy.md): Deploy a private Polygon CDK chain where transaction data stays in your infrastructure and Ethereum settles a validity proof. Built on OP Succinct AltDA. - [Changelog](https://docs.polygon.technology/changelog.md): Product updates across the Polygon ecosystem. - [Routes and discovery](https://docs.polygon.technology/cross-chain/api-reference/discovery.md): Discover supported networks, tokens, routes, and prices: GetChains, GetTokenList, routes, and pricing endpoints. - [Status and monitoring](https://docs.polygon.technology/cross-chain/api-reference/monitoring.md): Track intent status through to settlement: GetIntent, GetIntentReceipt, WaitIntentReceipt, SearchIntents, and GetIntentHistory. - [Cross-chain API overview](https://docs.polygon.technology/cross-chain/api-reference/overview.md): Authentication, base URL, and the intent lifecycle for the cross-chain payments API. - [Quotes and execution](https://docs.polygon.technology/cross-chain/api-reference/quotes.md): QuoteIntent, CommitIntent, ExecuteIntent, and AbortIntent. - [Earn accounts](https://docs.polygon.technology/cross-chain/earn.md): Offer customers a yield-bearing account powered by onchain lending markets, funded from a card or bank in one step. - [Accept funds from anywhere](https://docs.polygon.technology/cross-chain/fund.md): Let customers fund your product from a card, bank account, exchange balance, or any wallet. - [Cross-chain payments, swaps, bridging, deposits, and actions](https://docs.polygon.technology/cross-chain/index.md): One Open Money Stack API for cross-chain payments, swaps, bridging, deposits, and composable onchain actions. Route customer funds from any token on any chain to any destination in one user action. - [Programmable destinations](https://docs.polygon.technology/cross-chain/money-actions.md): Execute a deposit, yield position, or any product action automatically when funds arrive. - [Building actions](https://docs.polygon.technology/cross-chain/sdk/composable-actions/building-actions.md): Reference for all composable action builders: swap, lend, deposit, assertCondition, and custom. - [Dynamic values](https://docs.polygon.technology/cross-chain/sdk/composable-actions/dynamic-values.md): Use dynamic() and self() to resolve amounts and addresses at execution time. - [Composable actions](https://docs.polygon.technology/cross-chain/sdk/composable-actions/index.md): Chain multiple onchain actions into a single intent: bridge, swap, stake, and deposit in one user signature. - [SDK configuration](https://docs.polygon.technology/cross-chain/sdk/configuration.md): Shared props reference for all Trails widget components. - [Earn component](https://docs.polygon.technology/cross-chain/sdk/earn.md): Open the market selector and let users deposit into DeFi yield protocols from any chain or funding source. - [React hooks](https://docs.polygon.technology/cross-chain/sdk/hooks.md): Hooks for building custom payment UIs with cross-chain routing and state. - [SDK quickstart](https://docs.polygon.technology/cross-chain/sdk/index.md): Install the SDK and drop in a payment widget in under five minutes. - [Pay component](https://docs.polygon.technology/cross-chain/sdk/pay.md): Accept exact-output payments where the recipient receives a precise amount regardless of the sender's source token. - [Swap component](https://docs.polygon.technology/cross-chain/sdk/swap.md): Cross-chain token swaps with automatic routing across bridges and DEXs. - [Swap & bridge](https://docs.polygon.technology/cross-chain/swap-bridge.md): Let customers move and convert funds across any network in a single step, without managing bridges or liquidity yourself. - [Use cases](https://docs.polygon.technology/cross-chain/use-cases.md): How fintechs, neobanks, banks, and marketplaces use cross-chain payment orchestration. - [Polygon Developer Docs](https://docs.polygon.technology/index.md): Polygon developer documentation: the Open Money Stack API for stablecoin payments, non-custodial wallets, on-ramps and off-ramps, cross-chain settlement, and the Polygon Chain, CDK, and Agglayer infrastructure that powers it. - [Polygon infrastructure: Polygon Chain, CDK, Agglayer, and agentic](https://docs.polygon.technology/infrastructure/index.md): The permissionless foundation of the Open Money Stack. Polygon Chain for public settlement, Polygon CDK for private blockchains, Agglayer for cross-chain interoperability, and agentic infrastructure for autonomous AI agent payments. - [Architecture](https://docs.polygon.technology/interoperability/agglayer/core-concepts/aggkit/architecture.md): AggKit's three-tier architecture: chain domain, synchronization components, and the Agglayer ecosystem, with certificate submission and GER propagation flows - [AggchainProofGen](https://docs.polygon.technology/interoperability/agglayer/core-concepts/aggkit/components/aggchain-proof-gen.md): How AggchainProofGen generates state transition proofs for chains requiring mathematical verification of internal operations beyond ECDSA signature authorization - [AggOracle](https://docs.polygon.technology/interoperability/agglayer/core-concepts/aggkit/components/aggoracle.md): How AggOracle propagates Global Exit Root updates from Ethereum L1 to L2 chains, and the v0.3.5 committee mode security improvement - [AggSender](https://docs.polygon.technology/interoperability/agglayer/core-concepts/aggkit/components/aggsender.md): How AggSender packages L2 state transitions into cryptographically signed certificates and submits them to Agglayer for Pessimistic Proof generation - [BridgeSync](https://docs.polygon.technology/interoperability/agglayer/core-concepts/aggkit/components/bridge-sync.md): How BridgeSync monitors and indexes bridge events from L1 and L2 networks, and how it provides data to AggSender and Bridge Service - [Components Overview](https://docs.polygon.technology/interoperability/agglayer/core-concepts/aggkit/components/index.md): The 7 AggKit components, their roles, dependencies, and which combinations are appropriate for different deployment scenarios - [L1InfoTreeSync](https://docs.polygon.technology/interoperability/agglayer/core-concepts/aggkit/components/l1infotree-sync.md): How L1InfoTreeSync monitors Ethereum L1 and maintains the L1 Info Tree and Rollup Exit Tree for proof generation and certificate building - [L2GERSync](https://docs.polygon.technology/interoperability/agglayer/core-concepts/aggkit/components/l2ger-sync.md): How L2GERSync indexes Global Exit Root updates on the L2 side and provides fast local GER state access for claim verification and Bridge Service APIs - [Architecture](https://docs.polygon.technology/interoperability/agglayer/core-concepts/architecture.md): Agglayer's technical architecture: the Agglayer node, Pessimistic Proof, Unified Bridge, and State Transition Proof and how they coordinate - [Architecture Overview](https://docs.polygon.technology/interoperability/agglayer/core-concepts/pessimistic-proof/architecture.md): How Pessimistic Proofs are generated and validated, and the financial isolation guarantees they provide - [Benchmarks](https://docs.polygon.technology/interoperability/agglayer/core-concepts/pessimistic-proof/benchmarks.md): Experimental performance analysis and benchmarks across different zkVM implementations - [Data Structures](https://docs.polygon.technology/interoperability/agglayer/core-concepts/pessimistic-proof/data-structures.md): Reference for the Sparse Merkle Trees and data structures used by Pessimistic Proof: Local Balance Tree, Nullifier Tree, Bridge Exits, MultiBatchHeader, and Certificate - [Proof Generation](https://docs.polygon.technology/interoperability/agglayer/core-concepts/pessimistic-proof/proof-generation.md): The Pessimistic Proof generation pipeline: certificate submission, native Rust validation, zkVM proof generation, and proof verification - [Aggchain Proof](https://docs.polygon.technology/interoperability/agglayer/core-concepts/state-transition-proof/aggchain-proof.md): Reference for Aggchain Proof: ECDSA and generic validity proof consensus types, data structures, verification steps, and bridge constraint details - [Architecture Overview](https://docs.polygon.technology/interoperability/agglayer/core-concepts/state-transition-proof/architecture.md): The State Transition Proof dual proof system: Local Chain, AggProver, and Agglayer roles, and how ECDSA and generic consensus types are handled - [Architecture Overview](https://docs.polygon.technology/interoperability/agglayer/core-concepts/unified-bridge/architecture.md): The Unified Bridge architecture: onchain contracts, off-chain services, data flow, and security properties - [Asset Bridging](https://docs.polygon.technology/interoperability/agglayer/core-concepts/unified-bridge/asset-bridging.md): How asset bridging works in the Unified Bridge: token type handling, bridgeAsset/claimAsset function signatures, and Merkle proof verification - [Bridge Components](https://docs.polygon.technology/interoperability/agglayer/core-concepts/unified-bridge/bridge-components.md): Reference for the Unified Bridge's onchain contracts, off-chain services, and APIs - [Data Structures](https://docs.polygon.technology/interoperability/agglayer/core-concepts/unified-bridge/data-structures.md): Reference for the Unified Bridge Merkle tree hierarchy: Local Exit Root, Rollup Exit Root, Mainnet Exit Root, Global Exit Root, and Global Index - [Message Bridging](https://docs.polygon.technology/interoperability/agglayer/core-concepts/unified-bridge/message-bridging.md): How message bridging works in the Unified Bridge: bridgeMessage/claimMessage function signatures, the IBridgeMessageReceiver interface, and execution flows - [What is Agglayer?](https://docs.polygon.technology/interoperability/agglayer/core-concepts/what-is-agglayer.md): CDK's interoperability layer: how it addresses blockchain fragmentation and what it enables for CDK chains - [Get Started](https://docs.polygon.technology/interoperability/agglayer/get-started/index.md): Build cross-chain applications on Agglayer-connected CDK chains. - [Agglayer: secure cross-chain bridge for heterogeneous blockchains](https://docs.polygon.technology/interoperability/agglayer/index.md): Agglayer is a secure cross-chain bridge that connects the liquidity and users of heterogeneous blockchains in a single interoperability protocol. Pessimistic proofs, unified liquidity, atomic cross-chain operations. Bundled with Polygon CDK. - [API Reference](https://docs.polygon.technology/interoperability/agglayer/integrations/aggkit-bridge-service/api-reference.md): REST API documentation for the AggKit Bridge Service: endpoints, parameters, and response formats. - [AggKit Bridge Service](https://docs.polygon.technology/interoperability/agglayer/integrations/aggkit-bridge-service/index.md): REST API for bridge data, transaction status, and proof generation without running AggKit infrastructure. - [API Reference](https://docs.polygon.technology/interoperability/agglayer/integrations/bridge-hub/api-reference.md): Bridge Hub REST API: endpoints, parameters, and response formats for querying bridge transactions. - [Architecture](https://docs.polygon.technology/interoperability/agglayer/integrations/bridge-hub/architecture.md): Bridge Hub system architecture: consumer internals, multi-network deployment, and database design. - [Auto-Claim Service](https://docs.polygon.technology/interoperability/agglayer/integrations/bridge-hub/auto-claim.md): Automated bridge transaction claiming: configuration, deployment, and security. - [Deployment](https://docs.polygon.technology/interoperability/agglayer/integrations/bridge-hub/deployment.md): Deploy Bridge Hub to production: Docker, Kubernetes, configuration, and troubleshooting. - [Bridge Hub](https://docs.polygon.technology/interoperability/agglayer/integrations/bridge-hub/index.md): Multi-chain bridge transaction indexing, API, and auto-claim system for Agglayer integrators. - [Integrations](https://docs.polygon.technology/interoperability/agglayer/integrations/index.md): Tools and APIs for integrating with Agglayer bridge infrastructure. - [Supported Chains](https://docs.polygon.technology/interoperability/agglayer/supported-chains.md): Chains connected to Agglayer: chain IDs, rollup IDs, RPC endpoints, block explorers, and gas tokens. - [Overview](https://docs.polygon.technology/interoperability/overview.md): Cross-chain infrastructure on Polygon: Agglayer for chain-level interoperability, Intents for application-level cross-chain execution. - [What is the Open Money Stack?](https://docs.polygon.technology/oms/overview.md): The Open Money Stack is Polygon's stablecoin payments infrastructure: fiat on-ramps and off-ramps, wallet infrastructure, compliance, stablecoin orchestration, and onchain settlement in one open, vertically integrated platform. - [ERC-8004 on Polygon](https://docs.polygon.technology/payment-services/agentic-payments/agent-integration/erc8004.md): Reference and explanation for ERC-8004: onchain Identity, Reputation, and Validation registries for autonomous agents. - [Agentic Payments Introduction](https://docs.polygon.technology/payment-services/agentic-payments/agent-integration/intro.md): Conceptual overview of agentic payments and how autonomous agents transact on Polygon. - [ERC-8004 agent identity](https://docs.polygon.technology/payment-services/agentic-payments/cli/agent-identity.md): Register an onchain agent identity and manage reputation through the ERC-8004 registries on Polygon mainnet. - [Balances and funding](https://docs.polygon.technology/payment-services/agentic-payments/cli/balances-and-funding.md): Check balances across one or many chains and fund the smart wallet through the Trails widget. - [Polygon Agent CLI](https://docs.polygon.technology/payment-services/agentic-payments/cli/index.md): Command-line toolkit for agents on Polygon: smart wallets, Trails for funding and swaps and yield, x402 micropayments, ERC-8004 identity, and Polymarket. - [Polymarket trading](https://docs.polygon.technology/payment-services/agentic-payments/cli/polymarket.md): Trade Polymarket prediction markets from the CLI: list markets, buy and sell YES/NO tokens via CLOB, manage positions. - [Setup and wallets](https://docs.polygon.technology/payment-services/agentic-payments/cli/setup-and-wallets.md): Initialize a project, create a smart wallet with spending limits, and manage wallet lifecycle. - [Swaps and yield](https://docs.polygon.technology/payment-services/agentic-payments/cli/swaps-and-yield.md): DEX swaps, cross-chain bridging, and Trails earn pools (Aave v3, Morpho, ERC-4626), all under the smart wallet. - [Transfers](https://docs.polygon.technology/payment-services/agentic-payments/cli/transfers.md): Send native tokens or ERC-20s from the smart wallet. Dry-run by default; broadcast with --broadcast. - [Pay an x402 endpoint](https://docs.polygon.technology/payment-services/agentic-payments/cli/x402-pay.md): Call an x402-protected resource from the CLI. The 402 is auto-paid and the request is retried as part of the same call. - [Cross-corridor vendor payouts](https://docs.polygon.technology/payment-services/agentic-payments/solutions/cross-corridor-payouts.md): Pay vendors and contractors in their preferred chain and currency from a single USDC treasury. Bridging is one command per recipient. - [Monetize an existing REST API](https://docs.polygon.technology/payment-services/agentic-payments/solutions/monetize-existing-api.md): Open a per-call revenue channel against your existing API for agent buyers. Settle in USDC on Polygon. - [Per-inference billing for AI APIs](https://docs.polygon.technology/payment-services/agentic-payments/solutions/per-inference-billing.md): Price model inference on actual token usage with the x402 v2 upto scheme. Polygon's mainnet facilitator runs v2 today. - [Polymarket hedging of operational risk](https://docs.polygon.technology/payment-services/agentic-payments/solutions/polymarket-hedging.md): Take small-dollar Polymarket positions to hedge regulatory, market, or event-driven risk from the CLI. - [Agentic SaaS metering](https://docs.polygon.technology/payment-services/agentic-payments/solutions/saas-metering.md): Add a per-action x402 channel to a seat-priced SaaS product. Keep enterprise contracts intact; bill agent traffic by usage. - [Treasury yield sweep](https://docs.polygon.technology/payment-services/agentic-payments/solutions/treasury-yield-sweep.md): Sweep idle USDC into Aave v3, Morpho, or ERC-4626 vaults from the CLI. Withdraw on a schedule before the next disbursement run. - [Facilitator Addresses](https://docs.polygon.technology/payment-services/agentic-payments/x402/analytics.md): Reference list of x402 Polygon mainnet and Amoy facilitator addresses for analytics and payment verification. - [x402 How It Works](https://docs.polygon.technology/payment-services/agentic-payments/x402/guides/how-it-works.md): How the x402 v2 protocol turns an HTTP 402 response into a verified onchain payment, with one round-trip and no signup. - [Migration: x402 V1 to V2](https://docs.polygon.technology/payment-services/agentic-payments/x402/guides/migration-v1-to-v2.md): Guide for upgrading Polygon x402 integrations from V1 to V2: packages, headers, network identifiers, and middleware patterns. - [x402 Quickstart for Buyers](https://docs.polygon.technology/payment-services/agentic-payments/x402/guides/quickstart-buyers.md): Tutorial: set up an x402 v2 buyer client on Polygon to automatically pay for and access paywalled API endpoints. - [x402 Quickstart for Sellers](https://docs.polygon.technology/payment-services/agentic-payments/x402/guides/quickstart-sellers.md): Tutorial: protect API endpoints with x402 v2 payment middleware to accept USDC payments on Polygon. - [x402 protocol: agentic payments over HTTP](https://docs.polygon.technology/payment-services/agentic-payments/x402/intro.md): x402 is the open payment protocol that brings onchain payments to the HTTP 402 Payment Required status code. Build agentic and AI agent payments for APIs and web services. Polygon-supported networks, facilitators, and quickstart. - [USDC Gateway Integration](https://docs.polygon.technology/payment-services/stablecoins/usdc-gateway-integration.md): How to integrate USDC on Polygon using Circle's Gateway (CCTP) for cross-chain transfers. - [USDC Native Integration](https://docs.polygon.technology/payment-services/stablecoins/usdc-native-integration.md): How to read balances and transfer native USDC on Polygon Chain using viem. - [Cash-ins](https://docs.polygon.technology/payments/cash-ins.md): Code-based cash deposits at retail locations that auto-convert to USDC. - [Compliance](https://docs.polygon.technology/payments/compliance.md): How the Open Money Stack handles KYC, KYB, AML, and transaction monitoring for regulated payment products. - [Account model](https://docs.polygon.technology/payments/core-concepts/account-model.md): OMS supports custodial, non-custodial, and agentic custody models. This page covers the account types used by the custodial model. - [Currencies and rails](https://docs.polygon.technology/payments/core-concepts/currencies-and-rails.md): Supported assets, networks, and payment rails in OMS. - [Entities and relationships](https://docs.polygon.technology/payments/core-concepts/entities.md): The core resources in OMS and how they relate to each other. - [Quote system](https://docs.polygon.technology/payments/core-concepts/quote-system.md): How OMS locks pricing, structures fees, and calculates exchange rates. - [Transaction lifecycle](https://docs.polygon.technology/payments/core-concepts/transaction-lifecycle.md): How a transaction moves through OMS from creation to completion, including statuses, sub-statuses, and webhook events. - [Customers](https://docs.polygon.technology/payments/customers.md): Identity records that own wallets, accounts, and transactions in OMS. - [Deposit addresses](https://docs.polygon.technology/payments/deposit-addresses.md): Persistent onchain addresses that auto-route incoming crypto to a wallet. - [External accounts](https://docs.polygon.technology/payments/external-accounts.md): Customer-owned bank accounts and saved addresses referenced as off-ramp destinations on a transaction. - [Get started](https://docs.polygon.technology/payments/get-started.md): Request access, authenticate, and run your first transaction on the Open Money Stack. - [Send from a wallet](https://docs.polygon.technology/payments/guides/crypto-to-fiat.md): Use the quote and transaction flow to move USDC out of a custodial wallet. Crypto destinations work today; bank payouts are early access. - [Customer onboarding](https://docs.polygon.technology/payments/guides/customer-onboarding.md): How to register a customer, collect identity verification, and provision their first wallet. - [Deposit addresses](https://docs.polygon.technology/payments/guides/deposit-addresses.md): How to create a persistent crypto deposit address that auto-converts incoming funds. - [Fiat to crypto](https://docs.polygon.technology/payments/guides/fiat-to-crypto.md): How to bring fiat into a customer's custodial wallet. - [Virtual accounts](https://docs.polygon.technology/payments/guides/virtual-accounts.md): How to give a customer a dedicated bank account number that auto-converts incoming ACH deposits to USDC. - [On-ramps & Off-ramps](https://docs.polygon.technology/payments/onramps-offramps.md): Convert between fiat and stablecoins via OMS or third-party providers on Polygon. - [Open Money Stack Payments API](https://docs.polygon.technology/payments/overview.md): Open Money Stack Payments API: fiat-to-crypto and crypto-to-fiat on-ramps, custodial wallets, compliance, and stablecoin orchestration in a single integration. ACH, wire, SWIFT, cash, and card rails. - [Explore Money Flows](https://docs.polygon.technology/payments/payment-flows.md): Interactive visualization of OMS payment flows and transaction routing. - [Payment Providers](https://docs.polygon.technology/payments/payment-providers.md): Directory of payment infrastructure projects supporting Polygon. - [Stablecoins](https://docs.polygon.technology/payments/stablecoins.md): Overview of stablecoins available on Polygon Chain, with integration guides for USDC and cross-chain transfers. - [Supported Jurisdictions](https://docs.polygon.technology/payments/supported-jurisdictions-networks.md): Jurisdiction eligibility for Polygon OMS, including prohibited countries and how restrictions are enforced. - [Transactions](https://docs.polygon.technology/payments/transactions.md): The core money movement operation in OMS: quote, then execute. - [Cash disbursements](https://docs.polygon.technology/payments/use-cases/cash-disbursement.md): Pay out from a digital wallet to physical cash at retail counters or ATMs. - [Cash to crypto on-ramp](https://docs.polygon.technology/payments/use-cases/cash-funding.md): Let US and global customers buy crypto with cash at 50,000+ convenience stores, gas stations, and pharmacies. A regulated cash-to-crypto on-ramp that funds digital wallets without a bank account or card. - [Consumer on-ramp and off-ramp](https://docs.polygon.technology/payments/use-cases/consumer-on-offramp.md): Fund a crypto wallet via cash-in or bank rails, and withdraw back to a bank. - [Stablecoin cross-border remittance](https://docs.polygon.technology/payments/use-cases/cross-border-remittance.md): Build cross-border remittance products on stablecoin rails: fiat in, fiat out, settled on Polygon in minutes instead of days. Skip the correspondent banking chain and the 5-7% fee. - [USD stablecoin accounts for global users](https://docs.polygon.technology/payments/use-cases/dollar-accounts.md): Give customers in any country a real USD account number for ACH transfers, backed by USDC on Polygon. Dollar banking and stablecoin-backed accounts without a US bank or correspondent banking chain. - [Payroll and contractor disbursements](https://docs.polygon.technology/payments/use-cases/payroll-disbursements.md): Pay workers and contractors in their local currency from a single USDC treasury wallet. - [Virtual accounts](https://docs.polygon.technology/payments/virtual-accounts.md): Dedicated bank account numbers that auto-convert incoming fiat to USDC. - [Introduction](https://docs.polygon.technology/pos/architecture/bor/introduction.md): How Bor, Polygon Chain's block production layer, works: producer selection, spans, sprints, stall detection, and state synchronization with Ethereum. - [Network configuration](https://docs.polygon.technology/pos/architecture/bor/network-config.md): Default ports used by Bor and Heimdall nodes for peer connections, RPC, WebSocket, monitoring, and discovery. - [State sync](https://docs.polygon.technology/pos/architecture/bor/state-sync.md): How state sync works in Polygon Chain, allowing Ethereum contract state to be reflected in Bor through the StateSender and StateReceiver contracts. - [Authentication](https://docs.polygon.technology/pos/architecture/heimdall_v2/authentication.md): How the Heimdall auth module handles account types, transaction validation, gas fees, AnteHandlers, and keepers. - [Balance transfers](https://docs.polygon.technology/pos/architecture/heimdall_v2/balance-transfers.md): How the Heimdall bank module handles multi-asset coin transfers, module accounts, supply tracking, send restrictions, and CLI/gRPC/REST query commands. - [Chain management](https://docs.polygon.technology/pos/architecture/heimdall_v2/chain-management.md): How the Heimdall chainmanager module stores and exposes PoS protocol parameters, including contract addresses, chain IDs, and confirmation block counts. - [Changes from v1](https://docs.polygon.technology/pos/architecture/heimdall_v2/changes-from-v1.md): Key differences between Heimdall v1 and v2, including encoding changes, the keyring requirement for validator signing, and vote extensions. - [Checkpoints](https://docs.polygon.technology/pos/architecture/heimdall_v2/checkpoints.md): How Heimdall checkpoints work, from proposal through Ethereum submission and acknowledgment, including the ABCI++ processing flow and message types. - [Clerk](https://docs.polygon.technology/pos/architecture/heimdall_v2/clerk.md): How the Heimdall clerk module manages state-sync event records from Ethereum, including the EventRecord structure and the validation flow. - [Governance](https://docs.polygon.technology/pos/architecture/heimdall_v2/governance.md): How the Heimdall governance module works, including proposal submission, voting, deposit handling, and parameter changes. - [Heimdall Bor module](https://docs.polygon.technology/pos/architecture/heimdall_v2/heimdall-bor-module.md): How the Heimdall bor module manages span intervals, selects block producers for the Bor chain, and coordinates span proposals through the ABCI++ side-transaction flow. - [Introduction](https://docs.polygon.technology/pos/architecture/heimdall_v2/introduction.md): What Heimdall-v2 is, what it does in the Polygon Chain architecture, and how it differs from the original Heimdall. - [Milestones](https://docs.polygon.technology/pos/architecture/heimdall_v2/milestones.md): How Heimdall milestones provide deterministic finality on Polygon Chain without waiting for checkpoints, using CometBFT vote extensions and 2/3 majority agreement. - [Staking](https://docs.polygon.technology/pos/architecture/heimdall_v2/staking.md): How the Heimdall stake module manages validator state, synchronizes Ethereum stake events to Heimdall, and updates the validator set. - [Topup](https://docs.polygon.technology/pos/architecture/heimdall_v2/topup.md): How the Heimdall topup module manages validator fee balances on Heimdall, including funding methods, bridge processing, and fee withdrawal. - [Overview](https://docs.polygon.technology/pos/architecture/overview.md): Architectural overview of Polygon Chain from a node perspective, covering the Heimdall-v2 consensus layer and Bor execution layer. - [Finality](https://docs.polygon.technology/pos/concepts/finality/finality.md): How finality works on Polygon Chain, including the milestone mechanism and the difference between probabilistic and deterministic finality. - [MATIC](https://docs.polygon.technology/pos/concepts/tokens/matic.md): What MATIC was as the native token of Polygon Chain, and its relationship to the POL token that replaced it. - [Migrate to POL](https://docs.polygon.technology/pos/concepts/tokens/matic-to-pol.md): How to migrate MATIC tokens to POL, depending on which chain they are currently on. - [POL](https://docs.polygon.technology/pos/concepts/tokens/pol.md): What POL is, how it works as the native token of Polygon Chain, and how its emission and governance mechanisms are designed. - [sPOL](https://docs.polygon.technology/pos/concepts/tokens/spol.md): What sPOL is, how Polygon's liquid staking token works, and how to stake POL to receive sPOL. - [EIP-1559](https://docs.polygon.technology/pos/concepts/transactions/eip-1559.md): How EIP-1559 changed gas estimation and transaction fees on Polygon Chain, and how Type 2 transactions differ from legacy transactions. - [EIP-4337](https://docs.polygon.technology/pos/concepts/transactions/eip-4337.md): How ERC-4337 account abstraction works on Polygon Chain, including UserOperations, Bundlers, EntryPoints, and Paymasters. - [Meta transactions](https://docs.polygon.technology/pos/concepts/transactions/meta-transactions.md): What meta transactions are, why they matter, and how the relayer model decouples gas payment from transaction signing on Polygon Chain. - [Becoming a validator](https://docs.polygon.technology/pos/get-started/becoming-a-validator.md): Requirements, responsibilities, and links to the step-by-step guides for joining and operating the Polygon Chain validator set. - [Building on PoS](https://docs.polygon.technology/pos/get-started/building-on-polygon.md): How to connect to Polygon Chain, deploy contracts, bridge tokens, and find the right tooling for your project. - [Governance fundamentals](https://docs.polygon.technology/pos/governance/governance-fundamentals.md): How Polygon Chain governance works, from off-chain ecosystem consensus through onchain upgrade execution. - [Ethereum to PoS](https://docs.polygon.technology/pos/how-to/bridging/ethereum-polygon/ethereum-to-matic.md): Deploy sender and receiver contracts to transfer arbitrary data from Ethereum to Polygon Chain using the state sync mechanism. - [PoS to Ethereum](https://docs.polygon.technology/pos/how-to/bridging/ethereum-polygon/matic-to-ethereum.md): Deploy child and root contracts to transfer data from Polygon Chain back to Ethereum using checkpoints and the RootChainManager. - [Polygon Portal](https://docs.polygon.technology/pos/how-to/bridging/ethereum-polygon/portal-ui.md): Reference overview of the Polygon Portal bridge, including how tokens are locked and minted when crossing between Ethereum and Polygon Chain. - [Submit mapping request](https://docs.polygon.technology/pos/how-to/bridging/ethereum-polygon/submit-mapping-request.md): Steps to submit a token mapping request to enable bridging between Ethereum and Polygon Chain. - [State Transfer](https://docs.polygon.technology/pos/how-to/bridging/l1-l2-communication/state-transfer.md): Overview of L1-L2 state transfer options on Polygon Chain, including state sync, FxPortal, and the token bridge. - [Delegate tokens](https://docs.polygon.technology/pos/how-to/delegate.md): Steps to delegate POL tokens to a validator, withdraw rewards, restake, and manage your stake on Polygon Chain. - [Run an Erigon archive node](https://docs.polygon.technology/pos/how-to/erigon-archive-node.md): Steps to install, configure, and start an Erigon archive node for Polygon Chain mainnet or Amoy testnet. - [Using Ansible](https://docs.polygon.technology/pos/how-to/full-node/full-node-ansible.md): Steps to deploy and manage a Polygon Chain full node using an Ansible playbook. - [Using binaries](https://docs.polygon.technology/pos/how-to/full-node/full-node-binaries.md): Steps to install Heimdall and Bor binaries, configure, and start a Polygon Chain full node. - [Using Docker](https://docs.polygon.technology/pos/how-to/full-node/full-node-docker.md): Steps to run a Polygon Chain full node using official Docker images, including Heimdall and Bor setup on Linux. - [Using GCP](https://docs.polygon.technology/pos/how-to/full-node/full-node-gcp.md): Steps to deploy a Polygon Chain node in a Google Cloud Platform VM instance using the gcloud CLI. - [Using packages](https://docs.polygon.technology/pos/how-to/full-node/full-node-packages.md): Steps to install Heimdall and Bor packages, configure, and start a Polygon Chain full node. - [Change owner and signer address](https://docs.polygon.technology/pos/how-to/operate-validator-node/change-signer-address.md): Steps to transfer your validator NFT to a new owner address or update the signer address for your Polygon Chain validator node. - [Next steps](https://docs.polygon.technology/pos/how-to/operate-validator-node/next-steps.md): Steps to stake tokens, set commission, claim rewards, and complete onboarding after your validator node joins the Polygon Chain active set. - [Top up Heimdall fee](https://docs.polygon.technology/pos/how-to/operate-validator-node/topup-heimdall-fee.md): Steps to top up the Heimdall fee for a Polygon Chain validator using the Staking UI or Etherscan. - [Validator performance requirements](https://docs.polygon.technology/pos/how-to/operate-validator-node/validator-performance.md): Reference for the validator performance parameters, benchmarks, grace periods, and forced unstaking process defined in PIP-4. - [Prerequisites](https://docs.polygon.technology/pos/how-to/prerequisites.md): System requirements, port configuration, and setup checklist for running a Polygon Chain full node or validator node. - [Sync node using snapshots](https://docs.polygon.technology/pos/how-to/snapshots.md): Steps to download and apply community snapshots to sync a Polygon Chain sentry, validator, or full node without syncing from scratch. - [Known issues and errors](https://docs.polygon.technology/pos/how-to/troubleshoot/known-issues.md): Diagnosis and resolution steps for common Bor and Heimdall errors encountered while running a Polygon Chain validator node. - [Reporting issues](https://docs.polygon.technology/pos/how-to/troubleshoot/reporting-issues.md): Where to report bugs, security vulnerabilities, and node issues for Polygon Chain, including bug bounty programs and support channels. - [Technical FAQs](https://docs.polygon.technology/pos/how-to/troubleshoot/technical-faqs.md): Reference answers to common technical questions about running Polygon Chain validator nodes, including key management, default directories, and troubleshooting commands. - [Using Ansible](https://docs.polygon.technology/pos/how-to/validator/validator-ansible.md): Steps to deploy a Polygon Chain sentry node and validator node using an Ansible playbook. - [Validator best practices](https://docs.polygon.technology/pos/how-to/validator/validator-best-practices.md): Security and operational best practices for running a Polygon Chain validator node, covering key management, OS hardening, networking, and monitoring. - [Using binaries](https://docs.polygon.technology/pos/how-to/validator/validator-binaries.md): Steps to install Heimdall and Bor binaries, configure sentry and validator nodes, and start a Polygon Chain validator using binaries. - [Using packages](https://docs.polygon.technology/pos/how-to/validator/validator-packages.md): Steps to install Heimdall and Bor packages, configure sentry and validator nodes, and start a Polygon Chain validator. - [Polygon Chain overview](https://docs.polygon.technology/pos/overview.md): Polygon Chain is an EVM-compatible blockchain anchored to Ethereum. Sub-5 second finality, 3,800 TPS, and $0.002 average transaction cost. Architecture, finality, and core contracts explained. - [Common commands](https://docs.polygon.technology/pos/reference/commands.md): Reference for common Bor and Heimdall commands used by Polygon Chain node operators. - [PoS mainnet multi-signatures](https://docs.polygon.technology/pos/reference/commit-chain-multisigs.md): Reference for active multi-signature wallets on the Polygon Chain mainnet and commitchain. - [Delegation via validator shares](https://docs.polygon.technology/pos/reference/contracts/delegation.md): Contract reference for the validator share delegation mechanism on Polygon Chain. - [Genesis contracts](https://docs.polygon.technology/pos/reference/contracts/genesis-contracts.md): List of genesis contracts deployed on Polygon Chain mainnet and Amoy testnet, with contract addresses. - [Staking manager](https://docs.polygon.technology/pos/reference/contracts/stakingmanager.md): Contract reference for the StakeManager contract on Polygon Chain, covering validator management, staking, and reward distribution. - [Mapped tokens](https://docs.polygon.technology/pos/reference/mapped-tokens.md): List of token mappings on the Polygon Chain mainnet and Amoy testnet. - [Network upgrade process](https://docs.polygon.technology/pos/reference/network-upgrade-process.md): Reference for Polygon Chain hardfork activations, versions, and the network upgrade process. - [Default ports for nodes](https://docs.polygon.technology/pos/reference/port-management.md): Reference for default ports used by Bor and Heimdall nodes on Polygon Chain. - [Rewards and staking incentives](https://docs.polygon.technology/pos/reference/rewards.md): Reference for Polygon Chain validator and delegator reward rates, staking incentives, and transaction fee distribution. - [RPC endpoints](https://docs.polygon.technology/pos/reference/rpc-endpoints.md): Network details and RPC endpoints for the Polygon Chain mainnet and Amoy testnet. - [Seed and bootnodes](https://docs.polygon.technology/pos/reference/seed-and-bootnodes.md): List of seed nodes and bootnodes for the Polygon Chain mainnet and Amoy testnet, for Bor and Heimdall. - [Setting Up Telemetry](https://docs.polygon.technology/pos/reference/telemetry-setup-guide.md): Configuration reference for setting up telemetry monitoring for Bor and Heimdall nodes. - [Build with AI](https://docs.polygon.technology/resources/build-with-ai.md): AI tools and integrations for building on OMS with your IDE or coding assistant. - [Guides](https://docs.polygon.technology/resources/guides.md): Browse guides across the Open Money Stack, filterable by product and use case. - [Chain Indexer Framework Overview](https://docs.polygon.technology/tools/chain-indexer-framework/overview.md): How the Chain Indexer Framework works and why it is useful for building event-driven dApp backends on EVM chains. - [Usage](https://docs.polygon.technology/tools/chain-indexer-framework/usage.md): How to install the Chain Indexer Framework and run the provided example pipelines. - [Hardhat](https://docs.polygon.technology/tools/dApp-development/common-tools/hardhat.md): Build, test, and deploy a smart contract to Polygon Amoy using Hardhat. - [Remix](https://docs.polygon.technology/tools/dApp-development/common-tools/remix.md): Deploy a HelloWorld smart contract to Polygon Amoy using Remix IDE and MetaMask. - [Replit](https://docs.polygon.technology/tools/dApp-development/common-tools/replit.md): Deploy a Solidity smart contract to Polygon Amoy using Replit IDE, without any local environment setup. - [Commands](https://docs.polygon.technology/tools/dApp-development/launchpad/commands.md): Complete reference for all dApp Launchpad CLI commands and their options. - [Common pitfalls](https://docs.polygon.technology/tools/dApp-development/launchpad/common-pitfalls.md): Known issues in dApp Launchpad with their causes and solutions. - [Contributing](https://docs.polygon.technology/tools/dApp-development/launchpad/contributing.md): How to build dApp Launchpad from source and run a local development environment for the tool itself. - [Frontend](https://docs.polygon.technology/tools/dApp-development/launchpad/frontend.md): How to work with the Next.js frontend in a dApp Launchpad project, including wallet connections, contract interactions, and deployment. - [dApp Launchpad Introduction](https://docs.polygon.technology/tools/dApp-development/launchpad/intro.md): What dApp Launchpad is, what it automates, and when to use it. - [Quickstart](https://docs.polygon.technology/tools/dApp-development/launchpad/quickstart.md): Build and run your first dApp Launchpad project from installation to a live local development environment. - [Smart contracts](https://docs.polygon.technology/tools/dApp-development/launchpad/smart-contracts.md): How to work with smart contracts in a dApp Launchpad project, including local deployment, the block explorer, and production deployment. - [Tutorials](https://docs.polygon.technology/tools/dApp-development/third-party-tutorials.md): Index of third-party resources and tutorials for developing, deploying, and managing dApps on Polygon. - [Interact with a node RPC](https://docs.polygon.technology/tools/dApp-development/tutorials/access-node.md): How to connect to a Polygon RPC provider and send your first blockchain request using Alchemy. - [The Graph](https://docs.polygon.technology/tools/data/thegraph.md): How to create, deploy, and query a subgraph for a Polygon smart contract using The Graph. - [Test token faucets](https://docs.polygon.technology/tools/gas/matic-faucet.md): How to obtain test POL and ETH tokens for Polygon testnets using third-party faucets. - [Estimate gas fees](https://docs.polygon.technology/tools/gas/polygon-gas-station.md): How to query Polygon Gas Station for gas price recommendations, and how to interpret the response. - [Developer Tools for Polygon](https://docs.polygon.technology/tools/index.md): Tools, integrations, and infrastructure for building on Polygon Chain. - [ABI manager](https://docs.polygon.technology/tools/matic-js/advanced/abi-manager.md): matic.js internally uses ABIManager for handling ABI management, configuration for you. All of the ABI and config are taken from static repo. - [Exit util](https://docs.polygon.technology/tools/matic-js/advanced/exit-util.md): matic.js internally use ExitUtil for generating proofs. It is a class which has different methods for helping with exit utilities. - [Plugin](https://docs.polygon.technology/tools/matic-js/advanced/plugin.md): Using plugin you can inject your code into matic.js. It can be used to write common set of generic codes which can be provided to anyone using a package. - [Matic.js API Architecture](https://docs.polygon.technology/tools/matic-js/api-architecture.md): The Matic.js library follows common api architecture throughout and the APIs are divided into two types: - [Get started](https://docs.polygon.technology/tools/matic-js/get-started.md): Matic.js a JavaScript library that facilitates interaction with the Polygon network. It provides developers with simplified operations such as depositing, trans - [POS client](https://docs.polygon.technology/tools/matic-js/pos/client.md): Make sure you have set up Matic.js by following the get started guide. - [Deposit ETH](https://docs.polygon.technology/tools/matic-js/pos/deposit-ether.md): Use the depositEther method to deposit ETH from ethereum to polygon. For example: - [approveAll](https://docs.polygon.technology/tools/matic-js/pos/erc1155/approve-all.md): The approveAll method can be used to approve all tokens on root token. - [approveAllForMintable](https://docs.polygon.technology/tools/matic-js/pos/erc1155/approve-all-for-mintable.md): The approveAllForMintable method can be used to approve all mintable tokens on root token. - [deposit](https://docs.polygon.technology/tools/matic-js/pos/erc1155/deposit.md): The deposit method can be used to deposit required amount of a token from ethereum to polygon chain. - [depositMany](https://docs.polygon.technology/tools/matic-js/pos/erc1155/deposit-many.md): The depositMany method can be used to deposit required amounts of multiple token from ethereum to polygon chain. - [getBalance](https://docs.polygon.technology/tools/matic-js/pos/erc1155/get-balance.md): The getBalance method can be used to get the balance of user for a token. It is available on both child and parent token. - [ERC1155 with Matic.js on Polygon PoS](https://docs.polygon.technology/tools/matic-js/pos/erc1155/index.md): POSClient provides erc1155 method which helps you to interact with a erc1155 token. - [isApprovedAll](https://docs.polygon.technology/tools/matic-js/pos/erc1155/is-approved-all.md): The isApprovedAll method checks if all tokens are approved for a user. It returns boolean value. - [isWithdrawExited](https://docs.polygon.technology/tools/matic-js/pos/erc1155/is-withdraw-exited.md): The isWithdrawExited method check if a withdraw has been exited. It returns boolean value. - [isWithdrawExitedMany](https://docs.polygon.technology/tools/matic-js/pos/erc1155/is-withdraw-exited-many.md): The isWithdrawExitedMany method check if withdraw has been exited for multiple tokens. It returns boolean value. - [transfer](https://docs.polygon.technology/tools/matic-js/pos/erc1155/transfer.md): The transfer method can be used to transfer tokens from one user to another user. - [withdrawExit](https://docs.polygon.technology/tools/matic-js/pos/erc1155/withdraw-exit.md): The withdrawExit method can be used to exit the withdraw process by using the txHash from withdrawStart method. - [withdrawExitFaster](https://docs.polygon.technology/tools/matic-js/pos/erc1155/withdraw-exit-faster.md): The withdrawExitFaster method can be used to exit the withdraw process by using the txHash from withdrawStart method. - [withdrawExitFasterMany](https://docs.polygon.technology/tools/matic-js/pos/erc1155/withdraw-exit-faster-many.md): The withdrawExitFasterMany method can be used to exit the withdraw process by using the txHash from withdrawStartMany method. - [withdrawExitMany](https://docs.polygon.technology/tools/matic-js/pos/erc1155/withdraw-exit-many.md): The withdrawExitMany method can be used to exit the withdraw process by using the txHash from withdrawStartMany method. - [withdrawStart](https://docs.polygon.technology/tools/matic-js/pos/erc1155/withdraw-start.md): The withdrawStart method can be used to initiate the withdraw process which will burn the specified amount of tokenId on polygon chain. - [withdrawStartMany](https://docs.polygon.technology/tools/matic-js/pos/erc1155/withdraw-start-many.md): The withdrawStartMany method can be used to initiate the withdraw process which will burn the specified amounts of multiple token respectively on polygon chain. - [approve](https://docs.polygon.technology/tools/matic-js/pos/erc20/approve.md): The approve method can be used to approve required amount on the root token. - [approveMax](https://docs.polygon.technology/tools/matic-js/pos/erc20/approve-max.md): The approveMax method can be used to approve max amount on the root token. - [deposit](https://docs.polygon.technology/tools/matic-js/pos/erc20/deposit.md): The deposit method can be used to deposit required amount from root token to child token. - [getAllowance](https://docs.polygon.technology/tools/matic-js/pos/erc20/get-allowance.md): The getAllowance method can be used to get the approved amount for the user. - [getBalance](https://docs.polygon.technology/tools/matic-js/pos/erc20/get-balance.md): The getBalance method can be used to get the balance of user. It is available on both child and parent token. - [ERC20 with Matic.js on Polygon PoS](https://docs.polygon.technology/tools/matic-js/pos/erc20/index.md): The POSClient has an erc20 method which returns an object of an ERC20 token. - [isWithdrawExited](https://docs.polygon.technology/tools/matic-js/pos/erc20/is-withdraw-exited.md): The isWithdrawExited method can be used to know whether the withdraw has been exited or not. - [transfer](https://docs.polygon.technology/tools/matic-js/pos/erc20/transfer.md): The transfer method can be used to transfer amount from one address to another address. - [withdrawExit](https://docs.polygon.technology/tools/matic-js/pos/erc20/withdraw-exit.md): The withdrawExit method can be used to exit the withdraw process by using the txHash from withdrawStart method. - [withdrawExitFaster](https://docs.polygon.technology/tools/matic-js/pos/erc20/withdraw-exit-faster.md): The withdrawExitFaster method can be used to exit the withdraw process faster by using the txHash from withdrawStart method. - [withdrawStart](https://docs.polygon.technology/tools/matic-js/pos/erc20/withdraw-start.md): The withdrawStart method can be used to initiate the withdraw process which will burn the specified amount on polygon chain. - [approve](https://docs.polygon.technology/tools/matic-js/pos/erc721/approve.md): The approve method can be used to approve required amount on root token. - [approveAll](https://docs.polygon.technology/tools/matic-js/pos/erc721/approve-all.md): The approveAll method can be used to approve all tokens. - [deposit](https://docs.polygon.technology/tools/matic-js/pos/erc721/deposit.md): The deposit method can be used to deposit a token from ethereum to polygon chain. - [depositMany](https://docs.polygon.technology/tools/matic-js/pos/erc721/deposit-many.md): The depositMany method can be used to deposit multiple token from ethereum to polygon chain. - [getAllTokens](https://docs.polygon.technology/tools/matic-js/pos/erc721/get-all-tokens.md): The getAllTokens method returns all tokens owned by specified user. - [getTokenIdAtIndexForUser](https://docs.polygon.technology/tools/matic-js/pos/erc721/get-token-id-at-index-for-user.md): The getTokenIdAtIndexForUser method returns token id on supplied index for user. - [getTokensCount](https://docs.polygon.technology/tools/matic-js/pos/erc721/get-tokens-count.md): The getTokensCount method returns tokens count for specified user. - [ERC721 with Matic.js on Polygon PoS](https://docs.polygon.technology/tools/matic-js/pos/erc721/index.md): POSClient provides erc721 method which helps you to interact with a erc721 token. - [isApproved](https://docs.polygon.technology/tools/matic-js/pos/erc721/is-approved.md): The isApproved method checks if token is approved for specified tokenId. It returns boolean value. - [isApprovedAll](https://docs.polygon.technology/tools/matic-js/pos/erc721/is-approved-all.md): The isApprovedAll method checks if all token is approved. It returns boolean value. - [isWithdrawExited](https://docs.polygon.technology/tools/matic-js/pos/erc721/is-withdraw-exited.md): The isWithdrawExited method check if a withdraw has been exited. It returns boolean value. - [isWithdrawExitedMany](https://docs.polygon.technology/tools/matic-js/pos/erc721/is-withdraw-exited-many.md): The isWithdrawExitedMany method check if withdraw has been exited for multiple tokens. It returns boolean value. - [transfer](https://docs.polygon.technology/tools/matic-js/pos/erc721/transfer.md): The transfer method can be used to transfer tokens from one user to another user. - [withdrawExit](https://docs.polygon.technology/tools/matic-js/pos/erc721/withdraw-exit.md): withdrawExit method can be used to exit the withdraw process by using the txHash from withdrawStart method. - [withdrawExitFaster](https://docs.polygon.technology/tools/matic-js/pos/erc721/withdraw-exit-faster.md): The withdrawExitFaster method can be used to exit the withdraw process by using the txHash from withdrawStart method. - [withdrawExitFasterMany](https://docs.polygon.technology/tools/matic-js/pos/erc721/withdraw-exit-faster-many.md): The withdrawExitFasterMany method can be used to exit the withdraw process by using the txHash from withdrawStartMany method. - [withdrawExitMany](https://docs.polygon.technology/tools/matic-js/pos/erc721/withdraw-exit-many.md): The withdrawExitMany method can be used to exit the withdraw process by using the txHash from withdrawStartMany method. - [withdrawStart](https://docs.polygon.technology/tools/matic-js/pos/erc721/withdraw-start.md): The withdrawStart method can be used to initiate the withdraw process which will burn the specified token on polygon chain. - [withdrawStartMany](https://docs.polygon.technology/tools/matic-js/pos/erc721/withdraw-start-many.md): The withdrawStartMany method can be used to initiate the withdraw process which will burn the multiple token on polygon chain. - [withdrawStartWithMetaData](https://docs.polygon.technology/tools/matic-js/pos/erc721/withdraw-start-with-meta-data.md): The withdrawStartWithMetaData method can be used to initiate the withdraw process which will burn the specified token on polygon chain. Under the hood it calls - [isCheckPointed](https://docs.polygon.technology/tools/matic-js/pos/is-check-pointed.md): The isCheckPointed method can be used to know if a transaction has been check-pointed. - [isDeposited](https://docs.polygon.technology/tools/matic-js/pos/is-deposited.md): The isDeposited method shows if a deposit has been completed. - [Set proof API](https://docs.polygon.technology/tools/matic-js/set-proof-api.md): The API links have been changed from https://apis.matic.network → https://proof-generator.polygon.technology. Please make sure to update the links. - [Ethers](https://docs.polygon.technology/tools/matic-js/setup/ethers.md): ethers.js is a library for interacting with the Ethereum Blockchain and its ecosystem. - [Web3js](https://docs.polygon.technology/tools/matic-js/setup/web3js.md): Web3.js is a collection of libraries that allow you to interact with a local or remote Ethereum node using HTTP, IPC or WebSocket. - [Chainlink](https://docs.polygon.technology/tools/oracles/chainlink.md): How to read a Chainlink price feed in a Solidity smart contract on Polygon. - [Chronicle](https://docs.polygon.technology/tools/oracles/chronicle.md): How to read Chronicle oracle price data in a Solidity smart contract on Polygon zkEVM. - [Getting Started with Polygon Oracles](https://docs.polygon.technology/tools/oracles/getting-started.md): An explanation of blockchain oracles and how they connect smart contracts to external data on Polygon. - [Supra](https://docs.polygon.technology/tools/oracles/supra.md): How to integrate Supra Pull Oracle and Push Oracle into a Polygon smart contract or JavaScript application. - [Bug bounty programs](https://docs.polygon.technology/tools/security/bugbounty.md): Active bug bounty programs for Polygon infrastructure, including platforms, scopes, and reward ranges. - [Contact us](https://docs.polygon.technology/tools/security/contact.md): Contact information for the Polygon Labs security team. - [Responsible disclosure](https://docs.polygon.technology/tools/security/disclosure.md): Steps for reporting a security vulnerability or CVE in Polygon technology to the security team before public disclosure. - [Governance & management](https://docs.polygon.technology/tools/security/governance.md): How Polygon Labs structures its security program using ISO/IEC 27001, including ISMS design, risk management, and policy governance. - [Human resources](https://docs.polygon.technology/tools/security/hr.md): Polygon Labs' security practices for personnel onboarding, offboarding, access provisioning, and security awareness training. - [Infrastructure](https://docs.polygon.technology/tools/security/infrastructure.md): Security practices for Polygon network infrastructure, including onchain monitoring and multisig signer requirements. - [Security operations](https://docs.polygon.technology/tools/security/operations.md): Polygon Labs' security operations practices, including logging, monitoring, incident response, and access control. - [Polygon Security Overview](https://docs.polygon.technology/tools/security/overview.md): How Polygon Labs approaches information security: team structure, monitoring, assessments, and bug bounties. - [Security reports](https://docs.polygon.technology/tools/security/reports.md): Public security audits, penetration tests, and certifications for Polygon infrastructure and applications. - [Risk management](https://docs.polygon.technology/tools/security/risk.md): Polygon Labs' approach to security risk management, including risk assessment methodology, control standards, residual risk handling, and compliance mapping. - [Software development](https://docs.polygon.technology/tools/security/sdlc.md): Security practices applied throughout Polygon Labs' software development lifecycle, including threat modeling, CI/CD controls, and pre-production assessments. - [Smart contracts](https://docs.polygon.technology/tools/security/smartcontracts.md): Polygon Labs' approach to smart contract security, including coding standards, internal review processes, and external audit practices. - [Vulnerability management](https://docs.polygon.technology/tools/security/vulnerability.md): How Polygon Labs identifies, tracks, prioritizes, and remediates security vulnerabilities across its systems and applications. - [Crust network](https://docs.polygon.technology/tools/storage/crusthelpers.md): How to integrate Crust Network decentralized storage with your Polygon dApp using available helper tools. - [Filecoin](https://docs.polygon.technology/tools/storage/filecoinhelpers.md): How to use Filecoin and IPFS storage services in your Polygon dApp for persistent, decentralized file storage. - [IPFS](https://docs.polygon.technology/tools/storage/ipfs.md): How to use IPFS for decentralized file storage in Polygon dApps, including example projects. - [AppKit](https://docs.polygon.technology/tools/wallets/appkit.md): How to integrate Reown AppKit for wallet connections in a Polygon dApp. - [Getting Started with Polygon Wallets](https://docs.polygon.technology/tools/wallets/getting-started.md): An overview of wallet options compatible with Polygon networks and how to choose one. - [Add Polygon network](https://docs.polygon.technology/tools/wallets/metamask/add-polygon-network.md): How to add Polygon Chain to MetaMask using ChainList, Polygonscan, or manual entry. - [MetaMask on Polygon](https://docs.polygon.technology/tools/wallets/metamask/overview.md): MetaMask key properties and security tips for use with Polygon networks. - [Polygon Portal](https://docs.polygon.technology/tools/wallets/portal.md): How to connect a wallet, bridge tokens, claim bridged assets, and add custom tokens using Polygon Portal. - [Reown](https://docs.polygon.technology/tools/wallets/reown.md): How to integrate Reown AppKit or WalletKit for wallet connections and Web3 UX on Polygon. - [WalletConnect](https://docs.polygon.technology/tools/wallets/walletconnect.md): Please view the third-party content disclaimer here. - [WalletKit](https://docs.polygon.technology/tools/wallets/walletkit.md): Please view the third-party content disclaimer here. - [Agentic Payments](https://docs.polygon.technology/wallets/agentic-wallets.md): Infrastructure for AI agents that initiate, negotiate, and settle payments autonomously on Polygon. - [Agentic Wallets](https://docs.polygon.technology/wallets/agentic-wallets-overview.md): Session-based smart contract wallets for AI agents that operate onchain autonomously. - [OMS Wallet Architecture](https://docs.polygon.technology/wallets/architecture.md): How OMS Wallet works: the WaaS embedded wallet service, wallet contracts v3, smart sessions, and the Guard Firewall. - [Authentication](https://docs.polygon.technology/wallets/authentication.md): Configure sign-in methods for non-custodial wallets: social login, email OTP, and custom OIDC or OAuth 2.0 providers. - [OMS Custodial Wallets](https://docs.polygon.technology/wallets/custodial-wallets.md): Managed wallets where OMS holds and secures private keys for your users, with KYC, AML, and compliance built in. - [Custodial wallet quickstart](https://docs.polygon.technology/wallets/custodial-wallets-quickstart.md): Authenticate, create a customer, and provision an OMS custodial wallet with the API. - [Custom Wallet](https://docs.polygon.technology/wallets/custom-wallet.md): Build a fully custom non-custodial wallet using the Wallet Development Kit on top of OMS wallet infrastructure. Self-host critical components if needed. - [Interactive Demo](https://docs.polygon.technology/wallets/examples/interactive-demo.md): An interactive walkthrough of a neobank built on OMS wallets, using mock data. - [Neobank iOS Demo](https://docs.polygon.technology/wallets/examples/neobank-ios.md): A white-label neobank and smart-wallet starter built on the OMS mobile wallet foundation. - [Guard Firewall](https://docs.polygon.technology/wallets/guard-firewall.md): Ecosystem-level transaction review that evaluates every transaction against policies, threat simulations, and blacklists before allowing onchain execution. - [Hosted Wallet](https://docs.polygon.technology/wallets/hosted-wallet.md): Launch a non-custodial wallet on your domain with OMS-operated infrastructure, branding control, Smart Sessions, and social or email authentication. - [OMS Wallet Infrastructure](https://docs.polygon.technology/wallets/infrastructure.md): How OMS Wallet keeps user keys non-custodial: Nitro Enclave isolation, attestation, encryption pool, Shamir-split KMS keys, and the Trusted Third Party council. - [Offer Yield Accounts to Your Users](https://docs.polygon.technology/wallets/morpho-vault-deposit.md): Add an interest-bearing savings feature to your fintech app. Users deposit funds, earn yield automatically, and withdraw at any time, with no crypto knowledge required. - [Multi-Auth Linking](https://docs.polygon.technology/wallets/multi-auth-linking.md): Attach multiple authentication methods to a single OMS Wallet for recovery and flexibility, with security guarantees against silent cross-provider linking. - [OMS Non-Custodial Wallets](https://docs.polygon.technology/wallets/non-custodial-wallets.md): Embedded wallets built into your app, with social login, custom OIDC providers, smart sessions, and an SDK. No browser extension, no seed phrase, no separate app. - [OMS wallets](https://docs.polygon.technology/wallets/overview.md): OMS wallets-as-a-service: custodial, non-custodial, and agentic wallets for applications. Chain-agnostic, with social login, smart sessions, and compliance built in. - [SDK Quickstart](https://docs.polygon.technology/wallets/quickstart.md): Install an OMS Wallet SDK, authenticate a non-custodial wallet, and send a first transaction. - [Recovery](https://docs.polygon.technology/wallets/recovery.md): How users recover access to their non-custodial wallet using multiple linked authentication methods and timed recovery. - [Backend Wallet Verification](https://docs.polygon.technology/wallets/sdk/guides/backend-wallet-verification.md): Verify OMS Wallet ID tokens on your backend against the staging JWKS. - [Send USDC](https://docs.polygon.technology/wallets/sdk/guides/send-usdc.md): Send USDC from a non-custodial wallet with SDKs that expose contract-call support. - [Kotlin SDK Authentication](https://docs.polygon.technology/wallets/sdk/kotlin/authentication.md): Authenticate users and resolve wallets with the Kotlin OMS Wallet SDK. - [Kotlin Blockchain Interaction](https://docs.polygon.technology/wallets/sdk/kotlin/blockchain-interaction.md): Send transactions, call contracts, verify signatures, and sign messages with the Kotlin OMS Wallet SDK. - [Kotlin Balances & History](https://docs.polygon.technology/wallets/sdk/kotlin/indexer.md): Read wallet balance data with the Kotlin OMS Wallet SDK. - [Kotlin Manage Sessions](https://docs.polygon.technology/wallets/sdk/kotlin/manage-sessions.md): Restore sessions, manage access, and sign out with the Kotlin OMS Wallet SDK. - [Kotlin SDK Quickstart](https://docs.polygon.technology/wallets/sdk/kotlin/quickstart.md): Install the Android Kotlin OMS Wallet SDK, create a client, and authenticate a wallet. - [SDKs Overview](https://docs.polygon.technology/wallets/sdk/overview.md): Learn what OMS wallets do and which SDKs are available. - [React Native SDK Authentication](https://docs.polygon.technology/wallets/sdk/react-native/authentication.md): Authenticate users and resolve wallets with the React Native OMS Wallet SDK. - [React Native Blockchain Interaction](https://docs.polygon.technology/wallets/sdk/react-native/blockchain-interaction.md): Send transactions, call contracts, verify signatures, and sign messages with the React Native OMS Wallet SDK. - [React Native Balances & History](https://docs.polygon.technology/wallets/sdk/react-native/indexer.md): Read wallet balance data with the React Native OMS Wallet SDK. - [React Native Manage Sessions](https://docs.polygon.technology/wallets/sdk/react-native/manage-sessions.md): Restore sessions, manage access, and sign out with the React Native OMS Wallet SDK. - [React Native SDK Quickstart](https://docs.polygon.technology/wallets/sdk/react-native/quickstart.md): Install the React Native OMS Wallet SDK, configure native clients, and authenticate a wallet with email OTP. - [Swift SDK Authentication](https://docs.polygon.technology/wallets/sdk/swift/authentication.md): Authenticate users and resolve wallets with the Swift OMS Wallet SDK. - [Swift Blockchain Interaction](https://docs.polygon.technology/wallets/sdk/swift/blockchain-interaction.md): Send transactions, call contracts, sign payloads, and verify signatures with the Swift OMS Wallet SDK. - [Swift Balances & History](https://docs.polygon.technology/wallets/sdk/swift/indexer.md): Read wallet balance data with the Swift OMS Wallet SDK. - [Swift Manage Sessions](https://docs.polygon.technology/wallets/sdk/swift/manage-sessions.md): Restore sessions, manage access, and sign out with the Swift OMS Wallet SDK. - [Swift SDK Quickstart](https://docs.polygon.technology/wallets/sdk/swift/quickstart.md): Install the Swift OMS Wallet SDK, create a client, and authenticate a wallet with email OTP. - [TypeScript SDK Authentication](https://docs.polygon.technology/wallets/sdk/typescript/authentication.md): Authenticate users and resolve wallets with the TypeScript OMS Wallet SDK. - [TypeScript Blockchain Interaction](https://docs.polygon.technology/wallets/sdk/typescript/blockchain-interaction.md): Send transactions, call contracts, verify signatures, and sign messages with the TypeScript OMS Wallet SDK. - [TypeScript Balances & History](https://docs.polygon.technology/wallets/sdk/typescript/indexer.md): Read wallet balance data with the TypeScript OMS Wallet SDK. - [TypeScript Manage Sessions](https://docs.polygon.technology/wallets/sdk/typescript/manage-sessions.md): Restore sessions, manage access, and sign out with the TypeScript OMS Wallet SDK. - [TypeScript SDK Quickstart](https://docs.polygon.technology/wallets/sdk/typescript/quickstart.md): Install the TypeScript OMS Wallet SDK, create a client, and authenticate a wallet with email OTP. - [Security](https://docs.polygon.technology/wallets/security.md): How keys are secured, transactions are validated, and the wallet remains non-custodial end to end. - [Smart Sessions](https://docs.polygon.technology/wallets/smart-sessions.md): Grant a remote backend or in-app flow limited, time-bounded, revocable access to send transactions from a user's wallet, enforced on-chain. - [Smart Sessions: Technical Deep Dive](https://docs.polygon.technology/wallets/smart-sessions-deep-dive.md): How Smart Sessions work under the hood: the Sessions Module, V3 config tree placement, session keys, lazy EIP-7702 delegation, and on-chain enforcement. - [Timed Recovery: Technical Reference](https://docs.polygon.technology/wallets/timed-recovery-technical.md): Full technical specification of the timed recovery flow, onchain observability, Operator independence, and recovery FAQ. - [Automate USDC collection with a Treasury Wallet](https://docs.polygon.technology/wallets/treasury-wallet.md): Use OMS wallets and Smart Sessions to automate pull-and-push USDC flows from client wallets to a central treasury, with no per-transfer approvals. - [Wallet Configuration](https://docs.polygon.technology/wallets/wallet-configuration.md): How the Merkleized wallet configuration works: single onchain root, signers, sessions, recovery, and cross-chain coherency. - [Wallet Operations](https://docs.polygon.technology/wallets/wallet-operations.md): Send transactions, transfer stablecoins, sign messages, and read balances from a non-custodial wallet. ## OpenAPI Specs - [openapi](https://docs.polygon.technology/api-reference/openapi.yaml)