rs-builder-relayer-client

Rust SDK for Polymarket's gasless relayer. Redeem positions, approve tokens, split/merge — zero gas.

Install

[dependencies]
rs-builder-relayer-client = "0.1"
ethers = "2"
tokio = { version = "1", features = ["full"] }

Usage

use polymarket_relayer::{operations, AuthMethod, RelayClient, RelayerTxType};

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let wallet = std::env::var("PRIVATE_KEY")?.parse()?;
    let client = RelayClient::new(
        137,
        wallet,
        AuthMethod::builder("key", "secret", "passphrase"),
        RelayerTxType::Safe,
    ).await?;

    // Redeem a settled position (gasless)
    let condition_id = hex::decode("ab12...cd34")?;  // 32 bytes
    let mut cid = [0u8; 32];
    cid.copy_from_slice(&condition_id);

    let tx = operations::redeem_regular(cid, &[1, 2]);
    let result = client.execute(vec![tx], "Redeem").await?.wait().await?;
    println!("tx: {}", result.tx_hash.unwrap_or_default());

    Ok(())
}

API

Auth

// Builder API keys (HMAC — enables gasless)
AuthMethod::builder("key", "secret", "passphrase")

// Relayer API keys (from polymarket.com/settings > API Keys)
AuthMethod::relayer_key("api_key", "wallet_address")

Direct Fallback (when relayer returns 429)

use polymarket_relayer::{DirectExecutor, RelayerError};

let direct = DirectExecutor::new("https://polygon-rpc.com", wallet, 137)?;

match client.execute(vec![tx], "Redeem").await {
    Err(RelayerError::QuotaExhausted) => {
        let result = direct.execute(&tx).await?;  // pays gas in MATIC
    }
    other => { /* handle normally */ }
}

Examples

cp .env.example .env   # fill in your keys

cargo run --example redeem_all                  # dry-run: scan positions
cargo run --example redeem_all -- --execute     # actually redeem
cargo run --example setup_wallet                # deploy Safe + approvals
cargo run --example redeem_single               # redeem one position
cargo run --example split_merge                 # split/merge demo

References

• Gasless Docs | Python SDK | TypeScript SDK

Donate

Ethereum / Polygon: 0xF4c6635dFfB53f21c500c1604EC284f8A8a7150D