Skip to main content
createSelfAndGasless() keeps custody with the trader EOA but submits trades through a Safe smart account.
  • the trader EOA owns USDC and positions
  • the trader EOA signs the underlying trade action
  • the trader’s Safe submits the transaction as a sponsored user operation

​
When to use it

  • consumer apps that want a gasless UX
  • embedded trading flows where the user should not need ETH after setup
  • client-side apps that already have a Safe execution path

​
One-time setup

The trader must do two EOA-signed transactions once: 
await client.approveUsdc('max');
await client.setupGaslessDelegation();
After that, trading calls can be sent gaslessly through the Safe.

​
Submit-capable client

const client = await OstiumClient.createSelfAndGasless({
  traderPrivateKey: process.env.TRADER_PRIVATE_KEY as `0x${string}`,
  pimlicoUrl: 'https://builder.ostium.io/v1/pimlico/sponsor?chainId=42161',
});

​
Build-only client

const client = await OstiumClient.createSelfAndGasless({
  traderAddress: '0xTraderAddress',
  safeAddress: '0xSafeAddress',
});

const tx = client.getOpenTradeTx({
  pairId: 0,
  buy: true,
  price: '65000',
  collateral: '100',
  leverage: '5',
  type: OrderType.Market,
});
In build-only mode, get*Tx() returns a Safe-style request with safeAddress and calls.

​
Parameters

FieldTypeRequiredNotes
traderPrivateKey0x${string}Submit-capableTrader EOA key. A Safe is derived from it to relay trades gaslessly.
traderAddress0x${string}Build-onlyTrader EOA address.
safeAddress0x${string}Build-onlySafe that submits delegated calls.
pimlicoUrlstringOptionalBundler/paymaster URL. Defaults to the Ostium sponsor URL (chain-aware).
rpcUrlstringOptionalRPC URL for reads/simulation. Defaults to the public RPC.
sponsorshipPolicyIdstringOptionalPimlico sponsorship policy ID.
Plus the shared options (testnet, slippageBps, builder, subgraphUrl, builderApiUrl, alchemyApiKey). See Client Configuration.