Relayer Client

npm install @polymarket/builder-relayer-client
# or
pnpm install @polymarket/builder-relayer-client

import { ethers } from "ethers";
import { RelayClient, RelayerTxType } from "@polymarket/builder-relayer-client";
import { BuilderApiKeyCreds, BuilderConfig } from "@polymarket/builder-signing-sdk";

const relayerUrl = process.env.POLYMARKET_RELAYER_URL;
const chainId = 137; // Polygon mainnet

// Create wallet
const provider = new ethers.providers.JsonRpcProvider(process.env.RPC_URL);
const wallet = new ethers.Wallet(process.env.PRIVATE_KEY, provider);

// Configure builder credentials
const builderCreds: BuilderApiKeyCreds = {
    key: process.env.BUILDER_API_KEY!,
    secret: process.env.BUILDER_SECRET!,
    passphrase: process.env.BUILDER_PASS_PHRASE!
};

const builderConfig = new BuilderConfig({
    localBuilderCreds: builderCreds
});

// Initialize client
const client = new RelayClient(relayerUrl, chainId, wallet, builderConfig);
// or explicitly:
const safeClient = new RelayClient(relayerUrl, chainId, wallet, builderConfig, RelayerTxType.SAFE);

// For Proxy Wallets (Magic Link users)
const proxyClient = new RelayClient(relayerUrl, chainId, wallet, builderConfig, RelayerTxType.PROXY);

import { BuilderConfig } from "@polymarket/builder-signing-sdk";

const builderConfig = new BuilderConfig({
    remoteBuilderConfig: {url: "http://localhost:3000/sign"}
});

const client = new RelayClient(relayerUrl, chainId, wallet, builderConfig);

const response = await client.deploy();
const result = await response.wait();

if (result) {
    console.log("Safe deployed successfully!");
    console.log("Transaction Hash:", result.transactionHash);
    console.log("Safe Address:", result.proxyAddress);
} else {
    console.log("Safe deployment failed");
}

import { ethers } from "ethers";
import { Interface } from "ethers/lib/utils";
import { Transaction } from "@polymarket/builder-relayer-client";

// Define ERC20 approval interface
const erc20Interface = new Interface([{
    "constant": false,
    "inputs": [
        {"name": "_spender", "type": "address"},
        {"name": "_value", "type": "uint256"}
    ],
    "name": "approve",
    "outputs": [{"name": "", "type": "bool"}],
    "payable": false,
    "stateMutability": "nonpayable",
    "type": "function"
}]);

// Create approval transaction
function createApprovalTransaction(
    tokenAddress: string,
    spenderAddress: string
): Transaction {
    return {
        to: tokenAddress,
        data: erc20Interface.encodeFunctionData("approve", [
            spenderAddress,
            ethers.constants.MaxUint256
        ]),
        value: "0"
    };
}

// Execute the approval
const usdcAddress = "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174";
const ctfAddress = "0x4d97dcd97ec945f40cf65f87097ace5ea0476045";

const approvalTx = createApprovalTransaction(usdcAddress, ctfAddress);
const response = await client.execute(
    [approvalTx],
    "Approve USDC for CTF"
);

const result = await response.wait();
console.log("Approval completed:", result?.transactionHash);

// Automatic waiting (recommended)
const response = await client.execute(transactions);
const result = await response.wait();

if (result) {
    console.log("Transaction confirmed:", result.transactionHash);
    console.log("Transaction state:", result.state);
} else {
    console.log("Transaction failed or timed out");
}