TypeScript SDK

git clone https://github.com/iliyakoz47-tech/ghostcopy.git
cd ghostcopy/packages/sdk-execution
npm install
npm run build

import {
  createSignedOrder,
  describeOrder,
  relayOrder,
  preflightOrder,
  cancelNonces,
} from "@scienter/sdk-execution";

// 1. the trader signs -- in their wallet, on their machine
const signed = await createSignedOrder(traderWallet, executorAddress, 8453, {
  pair: "HL:ETH-PERP",         // recorded on-chain, NOT enforced by it
  direction: "long",           // recorded on-chain, NOT enforced by it
  router, tokenIn, tokenOut,   // enforced
  amountIn: 1_000_000_000n,    // enforced, exact
  quotedAmountOut: 10n ** 18n, // enforced, the slippage reference
  sizeUSD: 1_000_000_000n,     // recorded on-chain, NOT enforced by it
  maxSlippageBps: 100,         // enforced, capped at 1000 on-chain
  expiryMinutes: 15,           // enforced, capped at 24h on-chain
  callHash,                    // binds the reasoning payload to the trade
});

// show the trader what it authorizes, in words, before the wallet prompt
console.log(describeOrder(signed.order).join("\n"));

// 2. Scienter's relayer submits it -- this is all the relayer key can do
const pre = await preflightOrder(publicClient, signed, relayerAddress);
if (!pre.ok) throw new Error(pre.problems.join("; "));
const { txHash, amountOut } = await relayOrder(relayWallet, publicClient, signed, routerCalldata);

// 3. the trader can cancel, alone, at any time before execution
await cancelNonces(traderWallet, executorAddress, [signed.order.nonce]);

npm test                              # unit tests, offline

cd ../../contracts && forge build     # required for the ABI drift guard
npm run gen-abi                       # after ANY change to ScopedExecutor.sol

anvil --port 8545                     # terminal 1
npm run e2e                           # terminal 2 -- deploys the real bytecode
                                       # and proves the SDK's EIP-712 encoding
                                       # matches the contract's byte-for-byte