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

# Contract Addresses

> Deployed smart contract addresses for Limora

This page lists the deployed smart contract addresses for the Limora protocol on Base network.

<Warning>
  Always verify contract addresses before interacting with them. Bookmark this
  page and cross-reference addresses from official sources.
</Warning>

***

## Base Mainnet

### Core Contracts

| Contract          | Address | Description                |
| ----------------- | ------- | -------------------------- |
| Trading Contract  | `TBD`   | Handles trade operations   |
| Matching Contract | `TBD`   | Manages liquidity matching |
| Vault Contract    | `TBD`   | Secure fund storage        |
| Oracle Aggregator | `TBD`   | Price feed aggregation     |

<Note>
  Contract addresses will be published here upon mainnet deployment. Please
  check back for updates.
</Note>

### Token Contracts

| Token | Address                                      | Decimals |
| ----- | -------------------------------------------- | -------- |
| USDC  | `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` | 6        |
| WETH  | `0x4200000000000000000000000000000000000006` | 18       |

### Oracle Contracts

| Oracle  | Address | Provider  |
| ------- | ------- | --------- |
| BTC/USD | `TBD`   | Chainlink |
| ETH/USD | `TBD`   | Chainlink |
| SOL/USD | `TBD`   | Pyth      |

***

## Base Sepolia (Testnet)

For testing and development purposes, Limora is deployed on Base Sepolia testnet.

### Core Contracts

| Contract          | Address | Description                |
| ----------------- | ------- | -------------------------- |
| Trading Contract  | `TBD`   | Handles trade operations   |
| Matching Contract | `TBD`   | Manages liquidity matching |
| Vault Contract    | `TBD`   | Secure fund storage        |
| Oracle Aggregator | `TBD`   | Price feed aggregation     |

### Test Tokens

| Token     | Address | Faucet                                          |
| --------- | ------- | ----------------------------------------------- |
| Test USDC | `TBD`   | [Request tokens](https://faucet.limora.finance) |
| Test WETH | `TBD`   | [Request tokens](https://faucet.limora.finance) |

***

## Contract Verification

All Limora contracts are verified on Basescan. You can view the source code and interact with contracts directly:

* **Basescan (Mainnet)**: [basescan.org](https://basescan.org)
* **Basescan (Sepolia)**: [sepolia.basescan.org](https://sepolia.basescan.org)

### Verification Steps

1. Navigate to the contract address on Basescan
2. Click the "Contract" tab
3. Verify the source code matches the official repository
4. Check the "Read Contract" and "Write Contract" sections

***

## Network Configuration

### Base Mainnet

```json theme={null}
{
  "chainId": 8453,
  "chainName": "Base",
  "nativeCurrency": {
    "name": "Ethereum",
    "symbol": "ETH",
    "decimals": 18
  },
  "rpcUrls": ["https://mainnet.base.org"],
  "blockExplorerUrls": ["https://basescan.org"]
}
```

### Base Sepolia Testnet

```json theme={null}
{
  "chainId": 84532,
  "chainName": "Base Sepolia",
  "nativeCurrency": {
    "name": "Ethereum",
    "symbol": "ETH",
    "decimals": 18
  },
  "rpcUrls": ["https://sepolia.base.org"],
  "blockExplorerUrls": ["https://sepolia.basescan.org"]
}
```

***

## Adding to Wallet

### MetaMask

<Steps>
  <Step title="Open Network Settings">
    Click the network dropdown in MetaMask and select "Add Network"
  </Step>

  <Step title="Add Custom RPC">Enter the network details from above</Step>

  <Step title="Import Tokens">
    Use "Import Token" and paste the token contract addresses
  </Step>
</Steps>

### Automatic Setup

Use Chainlist for one-click network addition:

* [Base Mainnet on Chainlist](https://chainlist.org/chain/8453)
* [Base Sepolia on Chainlist](https://chainlist.org/chain/84532)

***

## Security Audits

Limora smart contracts have been audited by:

| Auditor | Date | Report           |
| ------- | ---- | ---------------- |
| TBD     | TBD  | [View Report](#) |

<Note>
  Audit reports will be published upon completion. Even audited contracts may
  contain vulnerabilities. Never invest more than you can afford to lose.
</Note>

***

## Official Resources

To verify you're using official Limora resources:

| Resource      | Official URL                                           |
| ------------- | ------------------------------------------------------ |
| Website       | [limora.finance](https://limora.finance)               |
| App           | [limora.finance/trade](https://limora.finance/trade)   |
| Documentation | [docs.limora.finance](https://docs.limora.finance)     |
| Discord       | [discord.gg/62kNVXjnVG](https://discord.gg/62kNVXjnVG) |
| Twitter       | [@limoraprotocol](https://twitter.com/limoraprotocol)  |

<Warning>
  Beware of phishing attempts. Always verify URLs and never share your private
  keys or seed phrase. Limora team members will never DM you first or ask for
  your keys.
</Warning>

***

## Developer Resources

### Contract ABIs

Contract ABIs are available upon request. Contact us on Discord for access.

### SDK

For easier integration, use the Limora SDK:

```bash theme={null}
npm install @limora/sdk
```

```typescript theme={null}
import { Limora } from '@limora/sdk'

const limora = new Limora({
  network: 'base-mainnet',
  provider: window.ethereum,
})

// Interact with contracts
const position = await limora.openLong({
  pair: 'BTC-USDC',
  collateral: 100,
  leverage: 10,
})
```

***

<Card title="Protocol Overview" icon="diagram-project" href="/protocol/overview">
  Learn more about the protocol architecture.
</Card>