@anywalletkit/protocol-swap2-relay 0.0.0-stage → 0.1.1

package/dist/order.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/order.ts"],"sourcesContent":["/**\n * A Relay order, read strictly, hashed and attributed here.\n *\n *  - The order id is the EIP-712 `hashStruct` of the order under {@link RELAY_ORDER_TYPES} (no domain separator), as\n *    github.com/relayprotocol/relay-protocol-sdk (src/order/index.ts) computes it. Chain ids are STRINGS (Relay's own\n *    chain names), addresses and currencies are `bytes` (20 raw bytes on an EVM chain).\n *  - `orderSignature` is the solver's EIP-191 `personal_sign` over the 32 raw bytes of that id.\n *\n * The id a deposit names is a commitment to everything in the order — recipient, chain, token, minimum, refunds — so\n * recomputing it from the order the API hands over, and reading that same parsed order, is what binds the deposit\n * to terms the device has seen.\n */\nimport {secp256k1} from \"@noble/curves/secp256k1.js\";\nimport {hashMessage, hashStruct, hexToBytes, keccak256, type Hex} from \"viem\";\n\n/** Why an order, a quote or a deposit was refused. One code per check; the message says what was found. */\nexport type RelayRefusalCode =\n  | \"request-invalid\"\n  | \"chain-unsupported\"\n  | \"protocol-data-missing\"\n  | \"hub-type\"\n  | \"order-malformed\"\n  | \"order-version\"\n  | \"order-inputs\"\n  | \"order-payments\"\n  | \"order-calls\"\n  | \"order-fees\"\n  | \"solver-not-pinned\"\n  | \"input-chain\"\n  | \"input-currency\"\n  | \"input-amount\"\n  | \"input-weight\"\n  | \"output-chain\"\n  | \"output-recipient\"\n  | \"output-currency\"\n  | \"output-minimum\"\n  | \"output-expected\"\n  | \"output-deadline\"\n  | \"refund-missing\"\n  | \"refund-chain\"\n  | \"refund-recipient\"\n  | \"refund-currency\"\n  | \"refund-deadline\"\n  | \"order-id-mismatch\"\n  | \"signature-invalid\"\n  | \"payment-details\"\n  | \"tx-chain\"\n  | \"tx-target\"\n  | \"tx-selector\"\n  | \"tx-calldata\"\n  | \"tx-depositor\"\n  | \"tx-token\"\n  | \"tx-amount\"\n  | \"tx-id\"\n  | \"tx-value\"\n  | \"order-reused\"\n  | \"app-fee\"\n  | \"gas-topup\"\n  | \"quote-gas\"\n  | \"quote-expiry\"\n  | \"quote-steps\"\n  | \"quote-amounts\"\n  | \"quote-approval\"\n  | \"quote-shape\";\n\nexport class RelayRefusal extends Error {\n  readonly code: RelayRefusalCode;\n  constructor(code: RelayRefusalCode, detail: string) {\n    super(`relay: ${detail} [${code}]`);\n    this.name = \"RelayRefusal\";\n    this.code = code;\n  }\n}\n\nexport const RELAY_ORDER_TYPES = {\n  Order: [\n    {name: \"version\", type: \"string\"},\n    {name: \"solverChainId\", type: \"string\"},\n    {name: \"solver\", type: \"address\"},\n    {name: \"salt\", type: \"uint256\"},\n    {name: \"inputs\", type: \"Input[]\"},\n    {name: \"output\", type: \"Output\"},\n    {name: \"fees\", type: \"Fee[]\"},\n  ],\n  Input: [\n    {name: \"payment\", type: \"InputPayment\"},\n    {name: \"refunds\", type: \"InputRefund[]\"},\n  ],\n  InputPayment: [\n    {name: \"chainId\", type: \"string\"},\n    {name: \"currency\", type: \"bytes\"},\n    {name: \"amount\", type: \"uint256\"},\n    {name: \"weight\", type: \"uint256\"},\n  ],\n  InputRefund: [\n    {name: \"chainId\", type: \"string\"},\n    {name: \"recipient\", type: \"bytes\"},\n    {name: \"currency\", type: \"bytes\"},\n    {name: \"minimumAmount\", type: \"uint256\"},\n    {name: \"deadline\", type: \"uint32\"},\n    {name: \"extraData\", type: \"bytes\"},\n  ],\n  Output: [\n    {name: \"chainId\", type: \"string\"},\n    {name: \"payments\", type: \"OutputPayment[]\"},\n    {name: \"deadline\", type: \"uint32\"},\n    {name: \"calls\", type: \"bytes[]\"},\n    {name: \"extraData\", type: \"bytes\"},\n  ],\n  OutputPayment: [\n    {name: \"recipient\", type: \"bytes\"},\n    {name: \"currency\", type: \"bytes\"},\n    {name: \"minimumAmount\", type: \"uint256\"},\n    {name: \"expectedAmount\", type: \"uint256\"},\n  ],\n  Fee: [\n    {name: \"recipientChainId\", type: \"string\"},\n    {name: \"recipient\", type: \"bytes\"},\n    {name: \"currencyChainId\", type: \"string\"},\n    {name: \"currency\", type: \"bytes\"},\n    {name: \"amount\", type: \"uint256\"},\n  ],\n} as const;\n\nexport interface RelayInputRefund {chainId: string; recipient: Hex; currency: Hex; minimumAmount: bigint; deadline: number; extraData: Hex}\nexport interface RelayInput {payment: {chainId: string; currency: Hex; amount: bigint; weight: bigint}; refunds: RelayInputRefund[]}\nexport interface RelayOutputPayment {recipient: Hex; currency: Hex; minimumAmount: bigint; expectedAmount: bigint}\nexport interface RelayFee {recipientChainId: string; recipient: Hex; currencyChainId: string; currency: Hex; amount: bigint}\n/** An order after {@link parseRelayOrder}: hex lowercased, integers exact. Every field below is hashed into the id. */\nexport interface RelayOrder {\n  version: string;\n  solverChainId: string;\n  solver: Hex;\n  salt: bigint;\n  inputs: RelayInput[];\n  output: {chainId: string; payments: RelayOutputPayment[]; deadline: number; calls: Hex[]; extraData: Hex};\n  fees: RelayFee[];\n}\n\nconst MAX_LIST = 8;\nconst MAX_BYTES_HEX = 2 + 2 * 1024;\nconst MAX_TEXT = 64;\nconst U256_MAX = (1n << 256n) - 1n;\n\nconst bad = (what: string): never => { throw new RelayRefusal(\"order-malformed\", `the order's ${what}`); };\n\nfunction rec(v: unknown, what: string): Record<string, unknown> {\n  if (v === null || typeof v !== \"object\" || Array.isArray(v)) bad(`${what} is not an object`);\n  return v as Record<string, unknown>;\n}\nfunction list(v: unknown, what: string): unknown[] {\n  if (!Array.isArray(v)) bad(`${what} is not a list`);\n  if ((v as unknown[]).length > MAX_LIST) bad(`${what} has more than ${MAX_LIST} entries`);\n  return v as unknown[];\n}\n/** Own property only: a field missing from the JSON is never read off a prototype. */\nfunction own(o: Record<string, unknown>, key: string): unknown {\n  return Object.prototype.hasOwnProperty.call(o, key) ? o[key] : undefined;\n}\nfunction text(v: unknown, what: string): string {\n  if (typeof v !== \"string\" || v.length === 0 || v.length > MAX_TEXT) bad(`${what} is not a short string`);\n  return v as string;\n}\n/** `bytes`: 0x-hex of whole bytes, lowercased. */\nfunction bytes(v: unknown, what: string): Hex {\n  if (typeof v !== \"string\" || v.length > MAX_BYTES_HEX || !/^0x(?:[0-9a-fA-F]{2})*$/.test(v)) bad(`${what} is not hex bytes`);\n  return (v as string).toLowerCase() as Hex;\n}\n/** `uint256`: a decimal string, a 0x-hex string (Relay writes the salt that way) or a safe non-negative integer. */\nfunction uint(v: unknown, what: string, max: bigint = U256_MAX): bigint {\n  let n: bigint | null = null;\n  if (typeof v === \"string\" && (/^(?:0|[1-9]\\d{0,77})$/.test(v) || /^0x[0-9a-fA-F]{1,64}$/.test(v))) n = BigInt(v);\n  else if (typeof v === \"number\" && Number.isSafeInteger(v) && v >= 0) n = BigInt(v);\n  if (n === null || n > max) bad(`${what} is not an unsigned integer in range`);\n  return n as bigint;\n}\nfunction uint32(v: unknown, what: string): number {\n  // Below 2^32, so the conversion is exact.\n  return parseInt(uint(v, what, 0xffff_ffffn).toString(10), 10);\n}\nfunction address(v: unknown, what: string): Hex {\n  if (typeof v !== \"string\" || !/^0x[0-9a-fA-F]{40}$/.test(v)) bad(`${what} is not an address`);\n  return (v as string).toLowerCase() as Hex;\n}\n\n/**\n * Read an order as the API gives it (`protocol.v2.orderData`, already JSON-parsed) into the one typed form the id,\n * the signature and every check are computed from. Anything that is not exactly the documented shape is refused\n * (`order-malformed`); keys the type does not have are ignored — they are outside the hash, and nothing reads them.\n */\nexport function parseRelayOrder(raw: unknown): RelayOrder {\n  const o = rec(raw, \"body\");\n  const output = rec(own(o, \"output\"), \"output\");\n  return {\n    version: text(own(o, \"version\"), \"version\"),\n    solverChainId: text(own(o, \"solverChainId\"), \"solver chain\"),\n    solver: address(own(o, \"solver\"), \"solver\"),\n    salt: uint(own(o, \"salt\"), \"salt\"),\n    inputs: list(own(o, \"inputs\"), \"inputs\").map((x, i) => {\n      const input = rec(x, `input ${i}`);\n      const p = rec(own(input, \"payment\"), `input ${i} payment`);\n      return {\n        payment: {\n          chainId: text(own(p, \"chainId\"), `input ${i} chain`),\n          currency: bytes(own(p, \"currency\"), `input ${i} currency`),\n          amount: uint(own(p, \"amount\"), `input ${i} amount`),\n          weight: uint(own(p, \"weight\"), `input ${i} weight`),\n        },\n        refunds: list(own(input, \"refunds\"), `input ${i} refunds`).map((y, j) => {\n          const r = rec(y, `refund ${j}`);\n          return {\n            chainId: text(own(r, \"chainId\"), `refund ${j} chain`),\n            recipient: bytes(own(r, \"recipient\"), `refund ${j} recipient`),\n            currency: bytes(own(r, \"currency\"), `refund ${j} currency`),\n            minimumAmount: uint(own(r, \"minimumAmount\"), `refund ${j} minimum`),\n            deadline: uint32(own(r, \"deadline\"), `refund ${j} deadline`),\n            extraData: bytes(own(r, \"extraData\"), `refund ${j} extra data`),\n          };\n        }),\n      };\n    }),\n    output: {\n      chainId: text(own(output, \"chainId\"), \"output chain\"),\n      payments: list(own(output, \"payments\"), \"output payments\").map((x, i) => {\n        const p = rec(x, `output payment ${i}`);\n        return {\n          recipient: bytes(own(p, \"recipient\"), `output payment ${i} recipient`),\n          currency: bytes(own(p, \"currency\"), `output payment ${i} currency`),\n          minimumAmount: uint(own(p, \"minimumAmount\"), `output payment ${i} minimum`),\n          expectedAmount: uint(own(p, \"expectedAmount\"), `output payment ${i} expected amount`),\n        };\n      }),\n      deadline: uint32(own(output, \"deadline\"), \"output deadline\"),\n      calls: list(own(output, \"calls\"), \"output calls\").map((x, i) => bytes(x, `output call ${i}`)),\n      extraData: bytes(own(output, \"extraData\"), \"output extra data\"),\n    },\n    fees: list(own(o, \"fees\"), \"fees\").map((x, i) => {\n      const f = rec(x, `fee ${i}`);\n      return {\n        recipientChainId: text(own(f, \"recipientChainId\"), `fee ${i} recipient chain`),\n        recipient: bytes(own(f, \"recipient\"), `fee ${i} recipient`),\n        currencyChainId: text(own(f, \"currencyChainId\"), `fee ${i} currency chain`),\n        currency: bytes(own(f, \"currency\"), `fee ${i} currency`),\n        amount: uint(own(f, \"amount\"), `fee ${i} amount`),\n      };\n    }),\n  };\n}\n\n/** The order id: `hashStruct(Order)`, no domain. */\nexport function relayOrderId(order: RelayOrder): Hex {\n  return hashStruct({types: RELAY_ORDER_TYPES, primaryType: \"Order\", data: order as never});\n}\n\n/**\n * The address whose `personal_sign` over the id's 32 bytes this signature is (lowercase), or null when it is not a\n * 65-byte secp256k1 signature that recovers at all. Synchronous on purpose: the same check runs wherever the order\n * is read, with nothing left for a later asynchronous step.\n */\nexport function relayOrderSigner(id: Hex, signature: unknown): Hex | null {\n  if (typeof signature !== \"string\" || !/^0x[0-9a-fA-F]{130}$/.test(signature)) return null;\n  const sig = hexToBytes(signature as Hex);\n  const v = sig[64]!;\n  const recovery = v === 27 || v === 28 ? v - 27 : v === 0 || v === 1 ? v : -1;\n  if (recovery < 0) return null;\n  try {\n    const recoverable = new Uint8Array(65);\n    recoverable[0] = recovery;\n    recoverable.set(sig.subarray(0, 64), 1);\n    const digest = hexToBytes(hashMessage({raw: id}));\n    const key = secp256k1.recoverPublicKey(recoverable, digest, {prehash: false});\n    // The recovery must also verify: a malformed (r, s) never passes as a signer.\n    if (!secp256k1.verify(sig.subarray(0, 64), digest, key, {prehash: false})) return null;\n    const uncompressed = secp256k1.Point.fromBytes(key).toBytes(false);\n    return `0x${keccak256(uncompressed.subarray(1)).slice(-40)}`.toLowerCase() as Hex;\n  } catch {\n    return null;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/order.d.cts

@@ -0,0 +1,178 @@
+import { Hex } from 'viem';
+
+/** Why an order, a quote or a deposit was refused. One code per check; the message says what was found. */
+type RelayRefusalCode = "request-invalid" | "chain-unsupported" | "protocol-data-missing" | "hub-type" | "order-malformed" | "order-version" | "order-inputs" | "order-payments" | "order-calls" | "order-fees" | "solver-not-pinned" | "input-chain" | "input-currency" | "input-amount" | "input-weight" | "output-chain" | "output-recipient" | "output-currency" | "output-minimum" | "output-expected" | "output-deadline" | "refund-missing" | "refund-chain" | "refund-recipient" | "refund-currency" | "refund-deadline" | "order-id-mismatch" | "signature-invalid" | "payment-details" | "tx-chain" | "tx-target" | "tx-selector" | "tx-calldata" | "tx-depositor" | "tx-token" | "tx-amount" | "tx-id" | "tx-value" | "order-reused" | "app-fee" | "gas-topup" | "quote-gas" | "quote-expiry" | "quote-steps" | "quote-amounts" | "quote-approval" | "quote-shape";
+declare class RelayRefusal extends Error {
+    readonly code: RelayRefusalCode;
+    constructor(code: RelayRefusalCode, detail: string);
+}
+declare const RELAY_ORDER_TYPES: {
+    readonly Order: readonly [{
+        readonly name: "version";
+        readonly type: "string";
+    }, {
+        readonly name: "solverChainId";
+        readonly type: "string";
+    }, {
+        readonly name: "solver";
+        readonly type: "address";
+    }, {
+        readonly name: "salt";
+        readonly type: "uint256";
+    }, {
+        readonly name: "inputs";
+        readonly type: "Input[]";
+    }, {
+        readonly name: "output";
+        readonly type: "Output";
+    }, {
+        readonly name: "fees";
+        readonly type: "Fee[]";
+    }];
+    readonly Input: readonly [{
+        readonly name: "payment";
+        readonly type: "InputPayment";
+    }, {
+        readonly name: "refunds";
+        readonly type: "InputRefund[]";
+    }];
+    readonly InputPayment: readonly [{
+        readonly name: "chainId";
+        readonly type: "string";
+    }, {
+        readonly name: "currency";
+        readonly type: "bytes";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "weight";
+        readonly type: "uint256";
+    }];
+    readonly InputRefund: readonly [{
+        readonly name: "chainId";
+        readonly type: "string";
+    }, {
+        readonly name: "recipient";
+        readonly type: "bytes";
+    }, {
+        readonly name: "currency";
+        readonly type: "bytes";
+    }, {
+        readonly name: "minimumAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint32";
+    }, {
+        readonly name: "extraData";
+        readonly type: "bytes";
+    }];
+    readonly Output: readonly [{
+        readonly name: "chainId";
+        readonly type: "string";
+    }, {
+        readonly name: "payments";
+        readonly type: "OutputPayment[]";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint32";
+    }, {
+        readonly name: "calls";
+        readonly type: "bytes[]";
+    }, {
+        readonly name: "extraData";
+        readonly type: "bytes";
+    }];
+    readonly OutputPayment: readonly [{
+        readonly name: "recipient";
+        readonly type: "bytes";
+    }, {
+        readonly name: "currency";
+        readonly type: "bytes";
+    }, {
+        readonly name: "minimumAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "expectedAmount";
+        readonly type: "uint256";
+    }];
+    readonly Fee: readonly [{
+        readonly name: "recipientChainId";
+        readonly type: "string";
+    }, {
+        readonly name: "recipient";
+        readonly type: "bytes";
+    }, {
+        readonly name: "currencyChainId";
+        readonly type: "string";
+    }, {
+        readonly name: "currency";
+        readonly type: "bytes";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+};
+interface RelayInputRefund {
+    chainId: string;
+    recipient: Hex;
+    currency: Hex;
+    minimumAmount: bigint;
+    deadline: number;
+    extraData: Hex;
+}
+interface RelayInput {
+    payment: {
+        chainId: string;
+        currency: Hex;
+        amount: bigint;
+        weight: bigint;
+    };
+    refunds: RelayInputRefund[];
+}
+interface RelayOutputPayment {
+    recipient: Hex;
+    currency: Hex;
+    minimumAmount: bigint;
+    expectedAmount: bigint;
+}
+interface RelayFee {
+    recipientChainId: string;
+    recipient: Hex;
+    currencyChainId: string;
+    currency: Hex;
+    amount: bigint;
+}
+/** An order after {@link parseRelayOrder}: hex lowercased, integers exact. Every field below is hashed into the id. */
+interface RelayOrder {
+    version: string;
+    solverChainId: string;
+    solver: Hex;
+    salt: bigint;
+    inputs: RelayInput[];
+    output: {
+        chainId: string;
+        payments: RelayOutputPayment[];
+        deadline: number;
+        calls: Hex[];
+        extraData: Hex;
+    };
+    fees: RelayFee[];
+}
+/**
+ * Read an order as the API gives it (`protocol.v2.orderData`, already JSON-parsed) into the one typed form the id,
+ * the signature and every check are computed from. Anything that is not exactly the documented shape is refused
+ * (`order-malformed`); keys the type does not have are ignored — they are outside the hash, and nothing reads them.
+ */
+declare function parseRelayOrder(raw: unknown): RelayOrder;
+/** The order id: `hashStruct(Order)`, no domain. */
+declare function relayOrderId(order: RelayOrder): Hex;
+/**
+ * The address whose `personal_sign` over the id's 32 bytes this signature is (lowercase), or null when it is not a
+ * 65-byte secp256k1 signature that recovers at all. Synchronous on purpose: the same check runs wherever the order
+ * is read, with nothing left for a later asynchronous step.
+ */
+declare function relayOrderSigner(id: Hex, signature: unknown): Hex | null;
+
+export { RELAY_ORDER_TYPES, type RelayFee, type RelayInput, type RelayInputRefund, type RelayOrder, type RelayOutputPayment, RelayRefusal, type RelayRefusalCode, parseRelayOrder, relayOrderId, relayOrderSigner };

package/dist/order.d.ts

@@ -0,0 +1,178 @@
+import { Hex } from 'viem';
+
+/** Why an order, a quote or a deposit was refused. One code per check; the message says what was found. */
+type RelayRefusalCode = "request-invalid" | "chain-unsupported" | "protocol-data-missing" | "hub-type" | "order-malformed" | "order-version" | "order-inputs" | "order-payments" | "order-calls" | "order-fees" | "solver-not-pinned" | "input-chain" | "input-currency" | "input-amount" | "input-weight" | "output-chain" | "output-recipient" | "output-currency" | "output-minimum" | "output-expected" | "output-deadline" | "refund-missing" | "refund-chain" | "refund-recipient" | "refund-currency" | "refund-deadline" | "order-id-mismatch" | "signature-invalid" | "payment-details" | "tx-chain" | "tx-target" | "tx-selector" | "tx-calldata" | "tx-depositor" | "tx-token" | "tx-amount" | "tx-id" | "tx-value" | "order-reused" | "app-fee" | "gas-topup" | "quote-gas" | "quote-expiry" | "quote-steps" | "quote-amounts" | "quote-approval" | "quote-shape";
+declare class RelayRefusal extends Error {
+    readonly code: RelayRefusalCode;
+    constructor(code: RelayRefusalCode, detail: string);
+}
+declare const RELAY_ORDER_TYPES: {
+    readonly Order: readonly [{
+        readonly name: "version";
+        readonly type: "string";
+    }, {
+        readonly name: "solverChainId";
+        readonly type: "string";
+    }, {
+        readonly name: "solver";
+        readonly type: "address";
+    }, {
+        readonly name: "salt";
+        readonly type: "uint256";
+    }, {
+        readonly name: "inputs";
+        readonly type: "Input[]";
+    }, {
+        readonly name: "output";
+        readonly type: "Output";
+    }, {
+        readonly name: "fees";
+        readonly type: "Fee[]";
+    }];
+    readonly Input: readonly [{
+        readonly name: "payment";
+        readonly type: "InputPayment";
+    }, {
+        readonly name: "refunds";
+        readonly type: "InputRefund[]";
+    }];
+    readonly InputPayment: readonly [{
+        readonly name: "chainId";
+        readonly type: "string";
+    }, {
+        readonly name: "currency";
+        readonly type: "bytes";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "weight";
+        readonly type: "uint256";
+    }];
+    readonly InputRefund: readonly [{
+        readonly name: "chainId";
+        readonly type: "string";
+    }, {
+        readonly name: "recipient";
+        readonly type: "bytes";
+    }, {
+        readonly name: "currency";
+        readonly type: "bytes";
+    }, {
+        readonly name: "minimumAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint32";
+    }, {
+        readonly name: "extraData";
+        readonly type: "bytes";
+    }];
+    readonly Output: readonly [{
+        readonly name: "chainId";
+        readonly type: "string";
+    }, {
+        readonly name: "payments";
+        readonly type: "OutputPayment[]";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint32";
+    }, {
+        readonly name: "calls";
+        readonly type: "bytes[]";
+    }, {
+        readonly name: "extraData";
+        readonly type: "bytes";
+    }];
+    readonly OutputPayment: readonly [{
+        readonly name: "recipient";
+        readonly type: "bytes";
+    }, {
+        readonly name: "currency";
+        readonly type: "bytes";
+    }, {
+        readonly name: "minimumAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "expectedAmount";
+        readonly type: "uint256";
+    }];
+    readonly Fee: readonly [{
+        readonly name: "recipientChainId";
+        readonly type: "string";
+    }, {
+        readonly name: "recipient";
+        readonly type: "bytes";
+    }, {
+        readonly name: "currencyChainId";
+        readonly type: "string";
+    }, {
+        readonly name: "currency";
+        readonly type: "bytes";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+};
+interface RelayInputRefund {
+    chainId: string;
+    recipient: Hex;
+    currency: Hex;
+    minimumAmount: bigint;
+    deadline: number;
+    extraData: Hex;
+}
+interface RelayInput {
+    payment: {
+        chainId: string;
+        currency: Hex;
+        amount: bigint;
+        weight: bigint;
+    };
+    refunds: RelayInputRefund[];
+}
+interface RelayOutputPayment {
+    recipient: Hex;
+    currency: Hex;
+    minimumAmount: bigint;
+    expectedAmount: bigint;
+}
+interface RelayFee {
+    recipientChainId: string;
+    recipient: Hex;
+    currencyChainId: string;
+    currency: Hex;
+    amount: bigint;
+}
+/** An order after {@link parseRelayOrder}: hex lowercased, integers exact. Every field below is hashed into the id. */
+interface RelayOrder {
+    version: string;
+    solverChainId: string;
+    solver: Hex;
+    salt: bigint;
+    inputs: RelayInput[];
+    output: {
+        chainId: string;
+        payments: RelayOutputPayment[];
+        deadline: number;
+        calls: Hex[];
+        extraData: Hex;
+    };
+    fees: RelayFee[];
+}
+/**
+ * Read an order as the API gives it (`protocol.v2.orderData`, already JSON-parsed) into the one typed form the id,
+ * the signature and every check are computed from. Anything that is not exactly the documented shape is refused
+ * (`order-malformed`); keys the type does not have are ignored — they are outside the hash, and nothing reads them.
+ */
+declare function parseRelayOrder(raw: unknown): RelayOrder;
+/** The order id: `hashStruct(Order)`, no domain. */
+declare function relayOrderId(order: RelayOrder): Hex;
+/**
+ * The address whose `personal_sign` over the id's 32 bytes this signature is (lowercase), or null when it is not a
+ * 65-byte secp256k1 signature that recovers at all. Synchronous on purpose: the same check runs wherever the order
+ * is read, with nothing left for a later asynchronous step.
+ */
+declare function relayOrderSigner(id: Hex, signature: unknown): Hex | null;
+
+export { RELAY_ORDER_TYPES, type RelayFee, type RelayInput, type RelayInputRefund, type RelayOrder, type RelayOutputPayment, RelayRefusal, type RelayRefusalCode, parseRelayOrder, relayOrderId, relayOrderSigner };

package/dist/order.js

@@ -0,0 +1,15 @@
+import {
+  RELAY_ORDER_TYPES,
+  RelayRefusal,
+  parseRelayOrder,
+  relayOrderId,
+  relayOrderSigner
+} from "./chunk-UVHDMGM5.js";
+export {
+  RELAY_ORDER_TYPES,
+  RelayRefusal,
+  parseRelayOrder,
+  relayOrderId,
+  relayOrderSigner
+};
+//# sourceMappingURL=order.js.map

package/dist/order.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}