> ## Documentation Index
> Fetch the complete documentation index at: https://docs.convallax.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Started

> Set up your wallet, get testnet USDC, and start trading Convallax options on Polygon Amoy.

Convallax is live on **Polygon Amoy testnet** (chain ID `80002`). Everything — option tokens, collateral, and settlement — uses testnet USDC with no real money at risk.

## Prerequisites

* A wallet that supports Polygon Amoy (MetaMask, Rabby, or any EVM wallet)
* Amoy testnet POL for gas fees

## Set Up Your Wallet

<Steps>
  <Step title="Add Polygon Amoy to your wallet">
    | Parameter      | Value                           |
    | -------------- | ------------------------------- |
    | Network name   | Polygon Amoy Testnet            |
    | RPC URL        | `https://polygon-amoy.drpc.org` |
    | Chain ID       | `80002`                         |
    | Currency       | POL                             |
    | Block explorer | `https://amoy.polygonscan.com`  |

    Most wallets auto-detect the network. If not, add it manually using the values above.
  </Step>

  <Step title="Get testnet POL for gas">
    Visit the [Polygon Amoy Faucet](https://faucet.polygon.technology/) to receive free testnet POL for transaction fees.
  </Step>

  <Step title="Get testnet USDC">
    Convallax includes a built-in faucet. Visit the app and click **Get Test USDC** to receive testnet tokens, or call the API directly:

    ```bash theme={null}
    curl -X POST https://api.convallax.com/faucet \
      -H "Content-Type: application/json" \
      -d '{ "wallet": "0xYourWalletAddress" }'
    ```

    The faucet drips 1,000 USDC per request with a **24-hour cooldown** per wallet.
  </Step>
</Steps>

## Contract Addresses

All contracts are deployed on Polygon Amoy (chain ID `80002`):

| Contract                    | Address                                      |
| --------------------------- | -------------------------------------------- |
| **ConvallaxCore**           | `0x76c41a03e0993F0261bB3B1949320cA693f76faE` |
| **ConvallaxOptionToken**    | `0x68a45fFc7d5282665ffa01Ec04ff133a4384F7e1` |
| **ConvallaxRFQSettlement**  | `0x3E583BC44157c91F8c534372A3e91c371841107A` |
| **USDC** (mintable testnet) | `0xCc544B615B244Cf59A7cB6Cb7d7119ef73A485E5` |

View any contract on [Amoy Polygonscan](https://amoy.polygonscan.com).

<Note>
  The testnet **USDC** above is a custom `MockUSDC` token deployed by Convallax — **not** Circle's USDC. The entire deployment is collateralized in this token, so it is the only USDC that works here. Get it from the Convallax faucet (the **Get Test USDC** button in the app, or [`POST /faucet`](/api-reference/testnet/faucet)) — minting is owner-gated, so the faucet is the only way to obtain it. Import this address into MetaMask to see your balance (6 decimals).
</Note>

## Your First Trade

<Steps>
  <Step title="Visit the trading interface">
    Go to [convallax.com/predict](https://convallax.com/predict) and connect your wallet.
  </Step>

  <Step title="Select an option">
    Choose a prediction market, pick your strike price and expiry, and select Call or Put.
  </Step>

  <Step title="Set your size">
    Enter the number of options you want to trade.
  </Step>

  <Step title="Submit your RFQ">
    Sign the EIP-712 request with your wallet. Market makers will compete to quote you a price.
  </Step>

  <Step title="Accept and fill">
    Review the best quote and approve. Your wallet will prompt you to call `fill()` on-chain, which atomically pays the premium, locks any required collateral, and mints your option tokens in one transaction.
  </Step>
</Steps>

## Available Markets

Convallax supports option grids registered by the protocol team. The current testnet deployment includes the 2026 FIFA World Cup winner markets:

| Market                                    | Strikes              | Expiries     | Types        |
| ----------------------------------------- | -------------------- | ------------ | ------------ |
| Will France win the 2026 FIFA World Cup?  | 10¢ – 25¢ (5¢ steps) | Jun 28, 2026 | Calls & puts |
| Will Spain win the 2026 FIFA World Cup?   | 10¢ – 25¢ (5¢ steps) | Jun 28, 2026 | Calls & puts |
| Will England win the 2026 FIFA World Cup? | 10¢ – 25¢ (5¢ steps) | Jun 28, 2026 | Calls & puts |

To discover the available markets and series programmatically, use the [List Markets](/api-reference/series/markets) and [List Series](/api-reference/series/list) endpoints.

<Info>
  New markets are registered by the protocol team. Series must exist on-chain before options can be traded. If you'd like a specific Polymarket market supported, reach out at [support@convallax.com](mailto:support@convallax.com).
</Info>

## Approvals

Settlement is **atomic mint-on-fill** — option tokens are minted when a trade executes, so there are no ERC-1155 approvals. You only ever approve **USDC**:

* **Buying options (long):** Approve USDC spending by `ConvallaxRFQSettlement` (premium).
* **Selling options (short):** Approve USDC spending by `ConvallaxCore` (collateral, posted at fill).

The frontend handles approval prompts automatically using the `takerApproval` returned by the commit response.

## Verify Your Positions

After a trade, you can verify your option token balances on-chain:

```bash theme={null}
# Check your ERC-1155 balance for a specific series
cast call 0x68a45fFc7d5282665ffa01Ec04ff133a4384F7e1 \
  "balanceOf(address,uint256)" \
  <your-wallet> <seriesId> \
  --rpc-url https://polygon-amoy.drpc.org
```