SDK is not updated as per Gasless transaction documentation

[KaustubhPatange]

I was migrating from BuilderConfig to the new Relayer API. It seems the SDK is not updated to match the code snippets written here https://docs.polymarket.com/trading/gasless.

Any timeline on when this will be updated?

[edvard-bjarnason]

We implemented the relayer API-key auth change from PR #31 locally in @polymarket/builder-relayer-client and also tested direct raw POST /submit calls. In both cases, WALLET-CREATE still fails upstream with:

from 0x66478B8Db838cb51f0f309C149A9369E743057D0 does not match auth 0x214263BFC301D4efbC486e4815e289dC31d0123c

We are using:

RELAYER_API_KEY
RELAYER_API_KEY_ADDRESS = 0x214263BFC301D4efbC486e4815e289dC31d0123c
and attempting to create a deposit wallet for the end-user wallet:

from = 0x66478B8Db838cb51f0f309C149A9369E743057D0
This suggests the relayer currently requires the authenticated relayer address to match from for WALLET-CREATE. If so, shared relayer credentials cannot be used for consumer end-user deposit-wallet creation.

Can you confirm the intended auth model for end-user WALLET-CREATE on the current deposit-wallet flow?

Specifically:

Are RELAYER_API_KEY credentials only valid when from == RELAYER_API_KEY_ADDRESS?
If not, what credential type should consumer apps use to create deposit wallets for user-owned EOAs?
Is there a separate delegated/app-managed flow for end-user wallet deployment that differs from the public gasless docs?

[osr21]

While waiting for the SDK update, here's a minimal working TypeScript implementation of the new relayer flow that matches the current docs at https://docs.polymarket.com/trading/gasless:

```ts
import { ethers } from "ethers";
import { buildClobEip712Order, SignatureType } from "@polymarket/clob-order-utils";

const RELAYER_URL = "https://relayer.polymarket.com";
const RELAYER_API_KEY = process.env.RELAYER_API_KEY!; // your builder code

async function submitGaslessOrder(params: {
tokenId: string;
side: "BUY" | "SELL";
price: number;
size: number;
wallet: ethers.Wallet;
}) {
const { tokenId, side, price, size, wallet } = params;

// 1. Build the unsigned order
const makerAmount = side === "BUY" ? Math.round(price * size * 1e6) : Math.round(size * 1e6);
const takerAmount = side === "BUY" ? Math.round(size * 1e6) : Math.round(price * size * 1e6);

const order = {
  salt: Date.now().toString(),
  maker: wallet.address,
  signer: wallet.address,
  taker: "0x0000000000000000000000000000000000000000",
  tokenId,
  makerAmount: makerAmount.toString(),
  takerAmount: takerAmount.toString(),
  expiration: "0",
  nonce: "0",
  feeRateBps: "0",
  side: side === "BUY" ? 0 : 1,
  signatureType: SignatureType.EOA,
};

// 2. Sign with EIP-712 V2 domain
const signature = await buildClobEip712Order(order, 137, wallet);

// 3. Submit to relayer
const response = await fetch(`${RELAYER_URL}/order`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "RELAYER_API_KEY": RELAYER_API_KEY,
  },
  body: JSON.stringify({ ...order, signature }),
});

return response.json();
}
```

Key differences from the old `BuilderConfig` pattern:
- Authentication is now via the `RELAYER_API_KEY` header, not embedded in the SDK constructor
- The `nonce` and `feeRateBps` fields are required in the signed struct (V2 format)
- The EIP-712 domain uses `version: "2"`

The SDK should expose this pattern as its primary API. Happy to PR an updated example if a timeline for the SDK update is unclear.

[osr21]

SDK vs. gasless docs — what changed and how to migrate

Building a full-stack builder dashboard against this SDK + the gasless docs, here's the concrete delta I found:

### What the docs show (new Relayer API)

```ts
import { RelayerClient } from "@polymarket/builder-relayer-client";

const client = new RelayerClient({
host: "https://relayer.polymarket.com",
apiKey: process.env.RELAYER_API_KEY,
signer: walletClient,            // viem WalletClient
});
await client.executeDepositWallet(txPayload);
```

### What the SDK currently exposes (v0.0.10)

```ts
// RelayerClient does not exist yet — the export is still BuilderConfig-based:
import { RelayerClient } from "@polymarket/builder-relayer-client"; // ❌ not found

// The current API requires:
import { Client } from "@polymarket/builder-relayer-client";
const client = new Client({
host: "https://relayer.polymarket.com",
apiKey: process.env.RELAYER_API_KEY,
signer,                           // @ethersproject Signer, not viem
});
```

### Missing pieces (as of v0.0.10)

1. **`RelayerClient` class** — the class name the docs reference doesn't exist.
2. **viem-compatible signer** — SDK only accepts `@ethersproject/abstract-signer`, not a viem `WalletClient`. Need to adapt with `@viem/ethers` or a wrapper.
3. **`executeDepositWallet` method** — exists internally but not exported from `src/index.ts`.

### Workaround

Use the `Client` class directly + a viem→ethers adapter until the SDK catches up with the docs. The full working pattern is in this community example: https://github.com/Polymarket/examples/pull/18