@derivexyz/derive-ts 3.0.4

package/dist/codecs/index.cjs

@@ -0,0 +1,319 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/codecs/index.ts
+var codecs_exports = {};
+__export(codecs_exports, {
+  VAULT_ACTION_KIND: () => VAULT_ACTION_KIND,
+  encodeCreateSessionKeyActionData: () => encodeCreateSessionKeyActionData,
+  encodeExternalTransfer: () => encodeExternalTransfer,
+  encodeRfqExecute: () => encodeRfqExecute,
+  encodeRfqQuote: () => encodeRfqQuote,
+  encodeTradeData: () => encodeTradeData,
+  encodeTransfer: () => encodeTransfer,
+  encodeUpdateWhitelistedRecipients: () => encodeUpdateWhitelistedRecipients,
+  encodeVaultBurnShares: () => encodeVaultBurnShares,
+  encodeVaultCancel: () => encodeVaultCancel,
+  encodeVaultCreate: () => encodeVaultCreate,
+  encodeVaultDeposit: () => encodeVaultDeposit,
+  encodeVaultMintShares: () => encodeVaultMintShares,
+  encodeVaultWithdraw: () => encodeVaultWithdraw,
+  encodeWithdrawal: () => encodeWithdrawal,
+  sortRfqLegs: () => sortRfqLegs
+});
+module.exports = __toCommonJS(codecs_exports);
+
+// src/codecs/trade.ts
+var import_ethers2 = require("ethers");
+
+// src/signing/encoding.ts
+var import_ethers = require("ethers");
+function toE18(value) {
+  return toScaled(value, 18);
+}
+function assertE12Precision(e18, field) {
+  if (e18 % 1000000n !== 0n) {
+    throw new Error(`${field} has more than 12 decimal places \u2014 the protocol runs at 1e12 precision`);
+  }
+}
+function unsignedE18(value, field) {
+  const scaled = toE18(value);
+  if (scaled < 0n) throw new Error(`${field} must not be negative`);
+  assertE12Precision(scaled, field);
+  return scaled;
+}
+function nonNegativeId(value, field) {
+  const valid = typeof value === "bigint" ? value >= 0n : Number.isSafeInteger(value) && value >= 0;
+  if (!valid) throw new Error(`${field} must be a non-negative integer`);
+  return value;
+}
+function toScaled(value, decimals) {
+  if (typeof value === "bigint") return value;
+  const text = typeof value === "number" ? String(value) : value.trim();
+  if (!/^-?\d+(\.\d+)?$/.test(text)) {
+    throw new Error(
+      `invalid decimal value: ${JSON.stringify(value)} (scientific notation and empty strings are not accepted)`
+    );
+  }
+  return (0, import_ethers.parseUnits)(text, decimals);
+}
+
+// src/codecs/trade.ts
+var I128_MIN = -(2n ** 127n);
+var I128_MAX = 2n ** 127n - 1n;
+var U64_MAX = 2n ** 64n - 1n;
+var U128_MAX = 2n ** 128n - 1n;
+function assertE12Precision2(e18, field) {
+  if (e18 % 1000000n !== 0n) {
+    throw new Error(`${field} has more than 12 decimal places \u2014 the protocol runs at 1e12 precision`);
+  }
+}
+function i128LowHalfWord(e18, field) {
+  if (e18 < I128_MIN || e18 > I128_MAX) {
+    throw new Error(`${field} out of range: e18-scaled value must fit in an i128`);
+  }
+  const twosComplement = e18 < 0n ? e18 + 2n ** 128n : e18;
+  return (0, import_ethers2.zeroPadValue)((0, import_ethers2.toBeHex)(twosComplement, 16), 32);
+}
+function uintWord(value, max, field) {
+  if (value < 0n || value > max) {
+    throw new Error(`${field} out of range: must be an unsigned integer <= ${max}`);
+  }
+  return (0, import_ethers2.zeroPadValue)((0, import_ethers2.toBeHex)(value), 32);
+}
+function encodeTradeData(fields) {
+  const limitPrice = toE18(fields.limitPrice);
+  const amount = toE18(fields.amount);
+  const maxFee = toE18(fields.maxFee);
+  assertE12Precision2(limitPrice, "limitPrice");
+  assertE12Precision2(amount, "amount");
+  assertE12Precision2(maxFee, "maxFee");
+  return (0, import_ethers2.concat)([
+    (0, import_ethers2.zeroPadValue)((0, import_ethers2.getAddress)(fields.assetAddress), 32),
+    uintWord(BigInt(fields.subId), U128_MAX, "subId"),
+    i128LowHalfWord(limitPrice, "limitPrice"),
+    i128LowHalfWord(amount, "amount"),
+    uintWord(maxFee, U128_MAX, "maxFee"),
+    uintWord(BigInt(fields.recipientSubaccountId), U64_MAX, "recipientSubaccountId"),
+    (0, import_ethers2.zeroPadValue)(fields.isBid ? "0x01" : "0x00", 32)
+  ]);
+}
+
+// src/codecs/transfer.ts
+var import_ethers3 = require("ethers");
+var TRANSFER_ABI = ["uint256", "uint256", "address", "uint256", "uint256", "uint256"];
+function encodeTransfer(fields) {
+  const amount = unsignedE18(fields.amount, "amount");
+  if (amount === 0n) throw new Error("transfer amount must be strictly positive");
+  return import_ethers3.AbiCoder.defaultAbiCoder().encode(TRANSFER_ABI, [
+    nonNegativeId(fields.toSubaccountId, "toSubaccountId"),
+    nonNegativeId(fields.newSubaccountManager, "newSubaccountManager"),
+    (0, import_ethers3.getAddress)(fields.asset),
+    nonNegativeId(fields.subId, "subId"),
+    amount,
+    unsignedE18(fields.maxFeeUsd, "maxFeeUsd")
+  ]);
+}
+
+// src/codecs/externalTransfer.ts
+var import_ethers4 = require("ethers");
+function encodeExternalTransfer(fields) {
+  return (0, import_ethers4.concat)([encodeTransfer(fields), (0, import_ethers4.zeroPadValue)((0, import_ethers4.getAddress)(fields.recipient), 32)]);
+}
+
+// src/codecs/withdrawal.ts
+var import_ethers5 = require("ethers");
+var WITHDRAWAL_ABI = ["address", "uint256", "address", "uint256", "bool"];
+function encodeWithdrawal(fields) {
+  if (!Number.isInteger(fields.decimals) || fields.decimals < 0 || fields.decimals > 255) {
+    throw new Error("decimals must be an integer between 0 and 255");
+  }
+  const amount = toScaled(fields.amount, fields.decimals);
+  if (amount <= 0n) throw new Error("withdrawal amount must be strictly positive");
+  return import_ethers5.AbiCoder.defaultAbiCoder().encode(WITHDRAWAL_ABI, [
+    (0, import_ethers5.getAddress)(fields.protocolAsset),
+    unsignedE18(fields.maxFeeUsd, "maxFeeUsd"),
+    (0, import_ethers5.getAddress)(fields.recipient),
+    amount,
+    fields.forceBatch
+  ]);
+}
+
+// src/codecs/rfq.ts
+var import_ethers6 = require("ethers");
+function sortRfqLegs(legs) {
+  return [...legs].sort(
+    (a, b) => a.instrumentName < b.instrumentName ? -1 : a.instrumentName > b.instrumentName ? 1 : 0
+  );
+}
+var LEGS_ABI = "(address,uint256,uint256,int256)[]";
+function encodeRfqQuote(fields) {
+  return import_ethers6.AbiCoder.defaultAbiCoder().encode(
+    [`(uint256,${LEGS_ABI})`],
+    [[maxFeeE18(fields.maxFee), legTuples(fields, 1n)]]
+  );
+}
+function encodeRfqExecute(fields) {
+  const coder = import_ethers6.AbiCoder.defaultAbiCoder();
+  const orderHash = (0, import_ethers6.keccak256)(coder.encode([LEGS_ABI], [legTuples(fields, -1n)]));
+  return coder.encode(["bytes32", "uint256"], [orderHash, maxFeeE18(fields.maxFee)]);
+}
+function maxFeeE18(maxFee) {
+  return unsignedE18(maxFee, "rfq maxFee");
+}
+function legTuples(fields, perspectiveSign) {
+  const directionSign = fields.direction === "buy" ? 1n : -1n;
+  return sortRfqLegs(fields.legs).map((leg) => {
+    const price = unsignedE18(leg.price, `rfq leg price (${leg.instrumentName})`);
+    const amount = toE18(leg.amount);
+    if (amount <= 0n)
+      throw new Error(`rfq leg amount must be positive (direction carries the sign): ${leg.instrumentName}`);
+    assertE12Precision(amount, `rfq leg amount (${leg.instrumentName})`);
+    const legSign = leg.direction === "buy" ? 1n : -1n;
+    return [
+      (0, import_ethers6.getAddress)(leg.assetAddress),
+      BigInt(leg.subId),
+      price,
+      amount * legSign * directionSign * perspectiveSign
+    ];
+  });
+}
+
+// src/codecs/vault.ts
+var import_ethers7 = require("ethers");
+var abi = import_ethers7.AbiCoder.defaultAbiCoder();
+var VAULT_ACTION_KIND = {
+  create: 0,
+  deposit: 1,
+  withdraw: 2,
+  cancel: 3,
+  mintShares: 4,
+  burnShares: 5
+};
+function positiveE18(label, value) {
+  const e18 = toE18(value);
+  if (e18 <= 0n) throw new Error(`${label} must be positive`);
+  assertE12Precision(e18, label);
+  return e18;
+}
+function encodeVaultDeposit(fields) {
+  return abi.encode(
+    ["uint256", "uint256", "address", "uint256"],
+    [
+      VAULT_ACTION_KIND.deposit,
+      fields.vaultSubaccountId,
+      (0, import_ethers7.getAddress)(fields.depositSpotAsset),
+      positiveE18("amount", fields.amount)
+    ]
+  );
+}
+function encodeVaultWithdraw(fields) {
+  return abi.encode(
+    ["uint256", "uint256", "uint256"],
+    [VAULT_ACTION_KIND.withdraw, fields.vaultSubaccountId, positiveE18("sharesToBurn", fields.sharesToBurn)]
+  );
+}
+function encodeVaultCancel(vaultSubaccountId) {
+  return abi.encode(["uint256", "uint256"], [VAULT_ACTION_KIND.cancel, vaultSubaccountId]);
+}
+function encodeVaultCreate(fields) {
+  const benchmark = fields.benchmarkAsset;
+  return abi.encode(
+    // prettier-ignore
+    ["uint256", "uint256", "address", "uint256", "uint256", "uint256", "uint256", "uint256", "uint256", "uint256", "address", "bool"],
+    [
+      VAULT_ACTION_KIND.create,
+      fields.managerId,
+      (0, import_ethers7.getAddress)(fields.depositSpotAsset),
+      unsignedE18(fields.initialDeposit, "initialDeposit"),
+      fields.managementFeeBps,
+      fields.performanceFeeBps,
+      fields.maxSlippageBps,
+      fields.cooldownSec,
+      unsignedE18(fields.maxFeeUsd, "maxFeeUsd"),
+      unsignedE18(fields.initialSharePriceUsd, "initialSharePriceUsd"),
+      benchmark === void 0 ? import_ethers7.ZeroAddress : (0, import_ethers7.getAddress)(benchmark),
+      benchmark !== void 0
+    ]
+  );
+}
+function encodeVaultMintShares(fields) {
+  return encodeSettleApproval(VAULT_ACTION_KIND.mintShares, fields.sharePrice, "depositHash", fields.depositHash);
+}
+function encodeVaultBurnShares(fields) {
+  return encodeSettleApproval(VAULT_ACTION_KIND.burnShares, fields.sharePrice, "withdrawHash", fields.withdrawHash);
+}
+function encodeSettleApproval(kind, sharePrice, hashLabel, hash) {
+  if (!(0, import_ethers7.isHexString)(hash, 32)) throw new Error(`${hashLabel} must be a 0x-prefixed 32-byte hex string`);
+  return abi.encode(["uint256", "uint256", "bytes32"], [kind, unsignedE18(sharePrice, "sharePrice"), hash]);
+}
+
+// src/codecs/sessionKey.ts
+var import_ethers8 = require("ethers");
+function encodeCreateSessionKeyActionData(data) {
+  if (!Number.isInteger(data.expirySec) || data.expirySec < 0) {
+    throw new Error(`session key expirySec must be a non-negative unix-seconds integer, got ${data.expirySec}`);
+  }
+  return (0, import_ethers8.concat)([
+    (0, import_ethers8.zeroPadValue)((0, import_ethers8.getAddress)(data.sessionKey), 32),
+    uintWord2(data.expirySec),
+    uintWord2(data.scopes.length),
+    uintWord2(data.subaccountIds.length),
+    ...data.scopes.map((code) => uintWord2(code)),
+    ...data.subaccountIds.map((id) => uintWord2(id))
+  ]);
+}
+function uintWord2(value) {
+  const valid = typeof value === "bigint" ? value >= 0n : Number.isSafeInteger(value) && value >= 0;
+  if (!valid) throw new Error(`expected a non-negative integer, got ${value}`);
+  return (0, import_ethers8.zeroPadValue)((0, import_ethers8.toBeHex)(value), 32);
+}
+
+// src/codecs/whitelistedRecipients.ts
+var import_ethers9 = require("ethers");
+function encodeUpdateWhitelistedRecipients(fields) {
+  const add = fields.add.map((a) => (0, import_ethers9.getAddress)(a));
+  const remove = fields.remove.map((a) => (0, import_ethers9.getAddress)(a));
+  return (0, import_ethers9.concat)([
+    (0, import_ethers9.zeroPadValue)((0, import_ethers9.toBeHex)(add.length), 32),
+    (0, import_ethers9.zeroPadValue)((0, import_ethers9.toBeHex)(remove.length), 32),
+    ...add.map((a) => (0, import_ethers9.zeroPadValue)(a, 32)),
+    ...remove.map((a) => (0, import_ethers9.zeroPadValue)(a, 32))
+  ]);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  VAULT_ACTION_KIND,
+  encodeCreateSessionKeyActionData,
+  encodeExternalTransfer,
+  encodeRfqExecute,
+  encodeRfqQuote,
+  encodeTradeData,
+  encodeTransfer,
+  encodeUpdateWhitelistedRecipients,
+  encodeVaultBurnShares,
+  encodeVaultCancel,
+  encodeVaultCreate,
+  encodeVaultDeposit,
+  encodeVaultMintShares,
+  encodeVaultWithdraw,
+  encodeWithdrawal,
+  sortRfqLegs
+});
+//# sourceMappingURL=index.cjs.map

package/dist/codecs/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/codecs/index.ts","../../src/codecs/trade.ts","../../src/signing/encoding.ts","../../src/codecs/transfer.ts","../../src/codecs/externalTransfer.ts","../../src/codecs/withdrawal.ts","../../src/codecs/rfq.ts","../../src/codecs/vault.ts","../../src/codecs/sessionKey.ts","../../src/codecs/whitelistedRecipients.ts"],"sourcesContent":["/**\n * Action-data codecs — the ABI encoders for each signed action's `data`\n * payload. Most users never need these: the namespaced APIs\n * (`client.orders`, `client.spotTransfers`, `client.positionTransfers`, …) build and sign actions for\n * you. They are exported for advanced callers assembling raw\n * `SignedAction`s themselves.\n */\nexport { encodeTradeData, type TradeActionFields } from './trade';\nexport { encodeTransfer, type TransferFields } from './transfer';\nexport { encodeExternalTransfer, type ExternalTransferFields } from './externalTransfer';\nexport { encodeWithdrawal, type WithdrawalFields } from './withdrawal';\nexport { encodeRfqQuote, encodeRfqExecute, sortRfqLegs, type RfqSignedLeg, type RfqQuoteFields } from './rfq';\nexport {\n  VAULT_ACTION_KIND,\n  encodeVaultDeposit,\n  encodeVaultWithdraw,\n  encodeVaultCancel,\n  encodeVaultCreate,\n  encodeVaultMintShares,\n  encodeVaultBurnShares,\n  type VaultDepositFields,\n  type VaultWithdrawFields,\n  type VaultCreateFields,\n  type VaultMintSharesFields,\n  type VaultBurnSharesFields,\n} from './vault';\nexport { encodeCreateSessionKeyActionData, type CreateSessionKeyData } from './sessionKey';\nexport { encodeUpdateWhitelistedRecipients, type WhitelistedRecipientsFields } from './whitelistedRecipients';\n","import { concat, getAddress, toBeHex, zeroPadValue } from 'ethers';\nimport { toE18, type DecimalLike } from '../signing/encoding';\n\n/**\n * Inputs to the trade (order) action payload, verified by the trade\n * module (`network.modules.trade`).\n */\nexport interface TradeActionFields {\n  /** Protocol asset contract of the instrument (`base_asset_address`). */\n  assetAddress: string;\n  /** Asset sub id (`base_asset_sub_id`): 0 for perps/spot, the option id for options. */\n  subId: string | number | bigint;\n  limitPrice: DecimalLike;\n  amount: DecimalLike;\n  /** Worst acceptable fee per unit traded the signature allows. */\n  maxFee: DecimalLike;\n  /** Subaccount credited with the fill — the trading subaccount itself. */\n  recipientSubaccountId: number | bigint;\n  isBid: boolean;\n}\n\nconst I128_MIN = -(2n ** 127n);\nconst I128_MAX = 2n ** 127n - 1n;\nconst U64_MAX = 2n ** 64n - 1n;\nconst U128_MAX = 2n ** 128n - 1n;\n\n/**\n * The exchange holds decimals at 1e12 and rejects (not truncates) signed\n * e18 words with sub-1e12 precision, so more than 12 decimal places can\n * never produce a valid signature.\n */\nfunction assertE12Precision(e18: bigint, field: string): void {\n  if (e18 % 1_000_000n !== 0n) {\n    throw new Error(`${field} has more than 12 decimal places — the protocol runs at 1e12 precision`);\n  }\n}\n\n/**\n * The exchange reads limit price and amount as an i128 from the LOW 16\n * bytes of the word; the high 16 bytes stay zero even for negative\n * values. Standard ABI int256 encoding would sign-extend the high half\n * and produce bytes the exchange rejects.\n */\nfunction i128LowHalfWord(e18: bigint, field: string): string {\n  if (e18 < I128_MIN || e18 > I128_MAX) {\n    throw new Error(`${field} out of range: e18-scaled value must fit in an i128`);\n  }\n  const twosComplement = e18 < 0n ? e18 + 2n ** 128n : e18;\n  return zeroPadValue(toBeHex(twosComplement, 16), 32);\n}\n\nfunction uintWord(value: bigint, max: bigint, field: string): string {\n  if (value < 0n || value > max) {\n    throw new Error(`${field} out of range: must be an unsigned integer <= ${max}`);\n  }\n  return zeroPadValue(toBeHex(value), 32);\n}\n\n/**\n * Encodes the order action data: seven static words — asset, subId,\n * limitPrice, amount, maxFee, recipientId, isBid — with\n * prices/amounts/fee e18-scaled.\n */\nexport function encodeTradeData(fields: TradeActionFields): string {\n  const limitPrice = toE18(fields.limitPrice);\n  const amount = toE18(fields.amount);\n  const maxFee = toE18(fields.maxFee);\n  assertE12Precision(limitPrice, 'limitPrice');\n  assertE12Precision(amount, 'amount');\n  assertE12Precision(maxFee, 'maxFee');\n  return concat([\n    zeroPadValue(getAddress(fields.assetAddress), 32),\n    uintWord(BigInt(fields.subId), U128_MAX, 'subId'),\n    i128LowHalfWord(limitPrice, 'limitPrice'),\n    i128LowHalfWord(amount, 'amount'),\n    uintWord(maxFee, U128_MAX, 'maxFee'),\n    uintWord(BigInt(fields.recipientSubaccountId), U64_MAX, 'recipientSubaccountId'),\n    zeroPadValue(fields.isBid ? '0x01' : '0x00', 32),\n  ]);\n}\n","import { parseUnits } from 'ethers';\n\n/**\n * A decimal value accepted from callers: a decimal string (\"1500.5\"),\n * a safe number, or a bigint already at the target field's wire scale\n * (e18 for most values; the ERC-20's native decimals for withdrawal\n * amounts).\n */\nexport type DecimalLike = string | number | bigint;\n\n/**\n * Converts a decimal value to the protocol's e18 wire scale. Signed\n * actions ABI-encode all prices/amounts/fees at 1e18 and signatures\n * commit to those exact bytes. (Withdrawal amounts are the exception —\n * they stay in the ERC-20's native decimals; see codecs/withdrawal.)\n */\nexport function toE18(value: DecimalLike): bigint {\n  return toScaled(value, 18);\n}\n\n/**\n * The exchange holds decimals at 1e12 and REJECTS (does not truncate) e18\n * words carrying sub-1e12 precision, so more than 12 decimal places can\n * never produce a valid signature. Holds for negative words too.\n */\nexport function assertE12Precision(e18: bigint, field: string): void {\n  if (e18 % 1_000_000n !== 0n) {\n    throw new Error(`${field} has more than 12 decimal places — the protocol runs at 1e12 precision`);\n  }\n}\n\n/** Scales to e18, rejecting negatives and sub-1e12 precision. Shared by the value-bearing codecs. */\nexport function unsignedE18(value: DecimalLike, field: string): bigint {\n  const scaled = toE18(value);\n  if (scaled < 0n) throw new Error(`${field} must not be negative`);\n  assertE12Precision(scaled, field);\n  return scaled;\n}\n\nexport function nonNegativeId(value: number | bigint, field: string): number | bigint {\n  const valid = typeof value === 'bigint' ? value >= 0n : Number.isSafeInteger(value) && value >= 0;\n  if (!valid) throw new Error(`${field} must be a non-negative integer`);\n  return value;\n}\n\n/** Default envelope validity for signed actions; comfortably above the API's minimum. */\nexport const DEFAULT_SIGNATURE_EXPIRY_SEC = 300;\n\nexport function toScaled(value: DecimalLike, decimals: number): bigint {\n  if (typeof value === 'bigint') return value;\n  const text = typeof value === 'number' ? String(value) : value.trim();\n  if (!/^-?\\d+(\\.\\d+)?$/.test(text)) {\n    throw new Error(\n      `invalid decimal value: ${JSON.stringify(value)} (scientific notation and empty strings are not accepted)`,\n    );\n  }\n  return parseUnits(text, decimals);\n}\n\n/**\n * Action nonces are UTC-nanosecond timestamps (the API accepts a\n * ±5-minute intake window), with sub-millisecond digits randomized so\n * concurrent actions never collide.\n */\nexport function randomNonce(now: number = Date.now()): string {\n  const nanos = BigInt(now) * 1_000_000n + BigInt(Math.floor(Math.random() * 1_000_000));\n  return nanos.toString();\n}\n\n/** Signature expiry as a unix-seconds timestamp, `seconds` from now. */\nexport function expiresIn(seconds: number, now: number = Date.now()): number {\n  return Math.floor(now / 1000) + seconds;\n}\n","import { AbiCoder, getAddress } from 'ethers';\nimport { nonNegativeId, unsignedE18, type DecimalLike } from '../signing/encoding';\n\n/**\n * Spot transfer between subaccounts of the same owner, verified by the\n * transfer module. Position transfers are booked as RFQ trades — this\n * action only ever moves a single spot asset.\n */\nexport interface TransferFields {\n  toSubaccountId: number | bigint;\n  /**\n   * Routing sentinel: 0 credits the existing `toSubaccountId`; non-zero\n   * creates a new subaccount under this manager id instead (the\n   * destination id is then ignored).\n   */\n  newSubaccountManager: number | bigint;\n  /** Protocol spot-asset address (not the underlying ERC-20). */\n  asset: string;\n  subId: number | bigint;\n  /** Strictly positive; signed at e18. */\n  amount: DecimalLike;\n  /** Maximum fee the signer authorises, in USD; signed at e18. */\n  maxFeeUsd: DecimalLike;\n}\n\nconst TRANSFER_ABI = ['uint256', 'uint256', 'address', 'uint256', 'uint256', 'uint256'];\n\n/** ABI-encodes transfer action data: six static 32-byte words. */\nexport function encodeTransfer(fields: TransferFields): string {\n  const amount = unsignedE18(fields.amount, 'amount');\n  if (amount === 0n) throw new Error('transfer amount must be strictly positive');\n  return AbiCoder.defaultAbiCoder().encode(TRANSFER_ABI, [\n    nonNegativeId(fields.toSubaccountId, 'toSubaccountId'),\n    nonNegativeId(fields.newSubaccountManager, 'newSubaccountManager'),\n    getAddress(fields.asset),\n    nonNegativeId(fields.subId, 'subId'),\n    amount,\n    unsignedE18(fields.maxFeeUsd, 'maxFeeUsd'),\n  ]);\n}\n","import { concat, getAddress, zeroPadValue } from 'ethers';\nimport { encodeTransfer, type TransferFields } from './transfer';\n\n/**\n * Spot transfer to another owner's wallet, verified by the external\n * transfer module: the six transfer words plus a seventh holding the\n * recipient wallet.\n */\nexport interface ExternalTransferFields extends TransferFields {\n  /**\n   * Destination owner wallet. `toSubaccountId` must be one of its existing\n   * subaccounts, or 0 to create one for it under `newSubaccountManager`.\n   */\n  recipient: string;\n}\n\n/**\n * All seven words are static, so the encoding is exactly the transfer\n * payload with the recipient appended as a left-padded address word.\n */\nexport function encodeExternalTransfer(fields: ExternalTransferFields): string {\n  return concat([encodeTransfer(fields), zeroPadValue(getAddress(fields.recipient), 32)]);\n}\n","import { AbiCoder, getAddress } from 'ethers';\nimport { toScaled, unsignedE18, type DecimalLike } from '../signing/encoding';\n\n/** Withdrawal to L1, verified by the withdrawal module. */\nexport interface WithdrawalFields {\n  /** Protocol asset contract address (not the underlying ERC-20). */\n  protocolAsset: string;\n  /** Maximum fee the signer authorises, in USD; signed at e18 like every other action value. */\n  maxFeeUsd: DecimalLike;\n  /** L1 payout recipient. The exchange only constructs withdrawals paying out to the action signer. */\n  recipient: string;\n  /**\n   * Withdrawal amount in the ERC-20's NATIVE decimals (USDC = 6) — the\n   * protocol's only never-scaled amount, since it is the L1 payout value.\n   */\n  amount: DecimalLike;\n  /** The underlying ERC-20's decimals, used to scale `amount`. */\n  decimals: number;\n  /** Pay a higher fee for immediate batch proving. */\n  forceBatch: boolean;\n}\n\nconst WITHDRAWAL_ABI = ['address', 'uint256', 'address', 'uint256', 'bool'];\n\n/** ABI-encodes withdrawal action data: five static 32-byte words. */\nexport function encodeWithdrawal(fields: WithdrawalFields): string {\n  if (!Number.isInteger(fields.decimals) || fields.decimals < 0 || fields.decimals > 255) {\n    throw new Error('decimals must be an integer between 0 and 255');\n  }\n  const amount = toScaled(fields.amount, fields.decimals);\n  if (amount <= 0n) throw new Error('withdrawal amount must be strictly positive');\n  return AbiCoder.defaultAbiCoder().encode(WITHDRAWAL_ABI, [\n    getAddress(fields.protocolAsset),\n    unsignedE18(fields.maxFeeUsd, 'maxFeeUsd'),\n    getAddress(fields.recipient),\n    amount,\n    fields.forceBatch,\n  ]);\n}\n","import { AbiCoder, getAddress, keccak256 } from 'ethers';\nimport { assertE12Precision, toE18, unsignedE18, type DecimalLike } from '../signing/encoding';\nimport type { Direction } from '../types';\n\n/**\n * RFQ action-data codecs.\n *\n * Maker and taker must hash byte-identical leg bundles: legs are sorted\n * lexicographically by instrument name, and each signed leg amount is\n * `amount × legDirectionSign × directionSign × perspectiveSign`. The maker\n * encodes with their own quote direction (perspective +1); the taker\n * executes with the opposite direction and perspective −1, which cancels\n * back to the maker's exact values — the server rebuilds the taker's\n * order hash from the maker's stored quote.\n */\n\n/** A quoted leg carrying everything the signature commits to. */\nexport interface RfqSignedLeg {\n  /** Canonical ordering key — both sides sign legs sorted by this. */\n  instrumentName: string;\n  /** Protocol asset contract for the instrument (option or perp). */\n  assetAddress: string;\n  /** Asset sub id: '0' for perps, the option's encoded sub id otherwise. */\n  subId: string | bigint;\n  /** Per-unit price, always positive; e18-scaled into the signed bytes. */\n  price: DecimalLike;\n  /** Unsigned size — direction carries the sign. */\n  amount: DecimalLike;\n  direction: Direction;\n}\n\nexport interface RfqQuoteFields {\n  /** Worst fee the signer accepts, in USD; e18 in the signed bytes. */\n  maxFee: DecimalLike;\n  /** The maker's quote direction (taker execute: the taker's own direction). */\n  direction: Direction;\n  legs: RfqSignedLeg[];\n}\n\n/** Sorts legs into the canonical order both counterparties sign and send. */\nexport function sortRfqLegs<T extends { instrumentName: string }>(legs: readonly T[]): T[] {\n  return [...legs].sort((a, b) =>\n    a.instrumentName < b.instrumentName ? -1 : a.instrumentName > b.instrumentName ? 1 : 0,\n  );\n}\n\nconst LEGS_ABI = '(address,uint256,uint256,int256)[]';\n\n/**\n * Maker quote data: `abi.encode(RfqOrder{ maxFee, trades[] })` —\n * `[0x20][maxFee][0x40][N][4 words per leg]`. Unlike the trade codec's\n * low-16-byte i128 amount words, a negative leg amount here is a full\n * sign-extended int256 (high 16 bytes 0xff), which is standard AbiCoder\n * output.\n */\nexport function encodeRfqQuote(fields: RfqQuoteFields): string {\n  return AbiCoder.defaultAbiCoder().encode(\n    [`(uint256,${LEGS_ABI})`],\n    [[maxFeeE18(fields.maxFee), legTuples(fields, 1n)]],\n  );\n}\n\n/**\n * Taker execute data: `abi.encode(bytes32 orderHash, uint256 maxFee)` where\n * `orderHash = keccak256(abi.encode(trades[]))` — the maker's legs only,\n * maker maxFee excluded. `fields.direction` is the TAKER's direction\n * (opposite of the quote's); `fields.maxFee` is the taker's own fee cap.\n */\nexport function encodeRfqExecute(fields: RfqQuoteFields): string {\n  const coder = AbiCoder.defaultAbiCoder();\n  const orderHash = keccak256(coder.encode([LEGS_ABI], [legTuples(fields, -1n)]));\n  return coder.encode(['bytes32', 'uint256'], [orderHash, maxFeeE18(fields.maxFee)]);\n}\n\nfunction maxFeeE18(maxFee: DecimalLike): bigint {\n  return unsignedE18(maxFee, 'rfq maxFee');\n}\n\nfunction legTuples(\n  fields: RfqQuoteFields,\n  perspectiveSign: 1n | -1n,\n): Array<readonly [string, bigint, bigint, bigint]> {\n  const directionSign = fields.direction === 'buy' ? 1n : -1n;\n  return sortRfqLegs(fields.legs).map((leg) => {\n    const price = unsignedE18(leg.price, `rfq leg price (${leg.instrumentName})`);\n    const amount = toE18(leg.amount);\n    if (amount <= 0n)\n      throw new Error(`rfq leg amount must be positive (direction carries the sign): ${leg.instrumentName}`);\n    assertE12Precision(amount, `rfq leg amount (${leg.instrumentName})`);\n    const legSign = leg.direction === 'buy' ? 1n : -1n;\n    return [\n      getAddress(leg.assetAddress),\n      BigInt(leg.subId),\n      price,\n      amount * legSign * directionSign * perspectiveSign,\n    ] as const;\n  });\n}\n","import { AbiCoder, ZeroAddress, getAddress, isHexString } from 'ethers';\nimport { assertE12Precision, toE18, unsignedE18, type DecimalLike } from '../signing/encoding';\n\n/**\n * Vault action encodings — shareholder intents (deposit/withdraw/cancel)\n * and curator actions (create, and the mint/burn settle approvals; in v3\n * anyone can curate a vault). Every vault action is signed under the\n * single vault module; word 0 is a uint256 kind word — the protocol's\n * ONLY discriminator between vault action types, so its high bytes must\n * be exactly zero. Deposits and withdrawals are queued intents the\n * curator later settles at a quoted share price committed to the\n * keccak256 of these exact bytes.\n */\n\nconst abi = AbiCoder.defaultAbiCoder();\n\n/** Word-0 kind discriminators. */\nexport const VAULT_ACTION_KIND = {\n  create: 0,\n  deposit: 1,\n  withdraw: 2,\n  cancel: 3,\n  mintShares: 4,\n  burnShares: 5,\n} as const;\n\n/**\n * Vault amounts are signed at e18 but held at e12 by the protocol,\n * which rejects (not truncates) sub-1e12 precision, and requires\n * strictly positive values.\n */\nfunction positiveE18(label: string, value: DecimalLike): bigint {\n  const e18 = toE18(value);\n  if (e18 <= 0n) throw new Error(`${label} must be positive`);\n  assertE12Precision(e18, label);\n  return e18;\n}\n\nexport interface VaultDepositFields {\n  vaultSubaccountId: number | bigint;\n  /** Must equal the vault's configured deposit asset (protocol spot-asset address). */\n  depositSpotAsset: string;\n  /** Deposit amount in the deposit asset's units; max 12 decimal places. */\n  amount: DecimalLike;\n}\n\n/** VaultDepositData (kind = 1, 4 words): [kind, vaultSubaccountId, depositSpotAsset, amountE18]. */\nexport function encodeVaultDeposit(fields: VaultDepositFields): string {\n  return abi.encode(\n    ['uint256', 'uint256', 'address', 'uint256'],\n    [\n      VAULT_ACTION_KIND.deposit,\n      fields.vaultSubaccountId,\n      getAddress(fields.depositSpotAsset),\n      positiveE18('amount', fields.amount),\n    ],\n  );\n}\n\nexport interface VaultWithdrawFields {\n  vaultSubaccountId: number | bigint;\n  /** Vault shares to redeem; max 12 decimal places. */\n  sharesToBurn: DecimalLike;\n}\n\n/** VaultWithdrawData (kind = 2, 3 words): [kind, vaultSubaccountId, sharesToBurnE18]. */\nexport function encodeVaultWithdraw(fields: VaultWithdrawFields): string {\n  return abi.encode(\n    ['uint256', 'uint256', 'uint256'],\n    [VAULT_ACTION_KIND.withdraw, fields.vaultSubaccountId, positiveE18('sharesToBurn', fields.sharesToBurn)],\n  );\n}\n\n/**\n * VaultCancelData (kind = 3, 2 words): [kind, vaultSubaccountId].\n * Invalidates ALL of the signer's pending intents for the vault by\n * bumping their per-(vault, holder) nonce to the envelope's nonce.\n */\nexport function encodeVaultCancel(vaultSubaccountId: number | bigint): string {\n  return abi.encode(['uint256', 'uint256'], [VAULT_ACTION_KIND.cancel, vaultSubaccountId]);\n}\n\nexport interface VaultCreateFields {\n  managerId: number;\n  depositSpotAsset: string;\n  /** Initial deposit moved funding subaccount → vault; max 12 decimal places. */\n  initialDeposit: DecimalLike;\n  managementFeeBps: number;\n  performanceFeeBps: number;\n  maxSlippageBps: number;\n  cooldownSec: number | bigint;\n  /** Maximum settlement fee authorised, in USD; max 12 decimal places. */\n  maxFeeUsd: DecimalLike;\n  /** Share price the vault is seeded at, in USD; max 12 decimal places. */\n  initialSharePriceUsd: DecimalLike;\n  /**\n   * Spot asset the high-water mark is denominated in. Omit for the\n   * feed-less USD default — presence drives the encoded hasBenchmark\n   * flag, exactly as the exchange derives it from the wire param.\n   */\n  benchmarkAsset?: string;\n}\n\n/**\n * Create-vault action data (kind = 0, 12 words):\n * [kind, managerId, depositSpotAsset, initialDepositE18,\n *  managementFeeBps, performanceFeeBps, maxSlippageBps, cooldownSec,\n *  maxFeeUsdE18, initialSharePriceUsdE18, benchmarkAsset, hasBenchmark].\n * bps rates and cooldownSec are plain integers, not e18.\n */\nexport function encodeVaultCreate(fields: VaultCreateFields): string {\n  const benchmark = fields.benchmarkAsset;\n  return abi.encode(\n    // prettier-ignore\n    ['uint256', 'uint256', 'address', 'uint256', 'uint256', 'uint256', 'uint256', 'uint256', 'uint256', 'uint256', 'address', 'bool'],\n    [\n      VAULT_ACTION_KIND.create,\n      fields.managerId,\n      getAddress(fields.depositSpotAsset),\n      unsignedE18(fields.initialDeposit, 'initialDeposit'),\n      fields.managementFeeBps,\n      fields.performanceFeeBps,\n      fields.maxSlippageBps,\n      fields.cooldownSec,\n      unsignedE18(fields.maxFeeUsd, 'maxFeeUsd'),\n      unsignedE18(fields.initialSharePriceUsd, 'initialSharePriceUsd'),\n      benchmark === undefined ? ZeroAddress : getAddress(benchmark),\n      benchmark !== undefined,\n    ],\n  );\n}\n\nexport interface VaultMintSharesFields {\n  /** Quoted share price in USD per share; max 12 decimal places. */\n  sharePrice: DecimalLike;\n  /** keccak256 of the user's exact encoded deposit action (0x hex, 32 bytes). */\n  depositHash: string;\n}\n\n/** MintSharesActionData (kind = 4): the curator's approval to settle one queued deposit. */\nexport function encodeVaultMintShares(fields: VaultMintSharesFields): string {\n  return encodeSettleApproval(VAULT_ACTION_KIND.mintShares, fields.sharePrice, 'depositHash', fields.depositHash);\n}\n\nexport interface VaultBurnSharesFields {\n  /** Quoted share price in USD per share; max 12 decimal places. */\n  sharePrice: DecimalLike;\n  /** keccak256 of the user's exact encoded withdraw action (0x hex, 32 bytes). */\n  withdrawHash: string;\n}\n\n/** BurnSharesActionData (kind = 5): the curator's approval to settle one queued withdrawal. */\nexport function encodeVaultBurnShares(fields: VaultBurnSharesFields): string {\n  return encodeSettleApproval(VAULT_ACTION_KIND.burnShares, fields.sharePrice, 'withdrawHash', fields.withdrawHash);\n}\n\n/**\n * Shared mint/burn layout (3 words): [kind, sharePriceE18, userActionHash].\n * The hash commits the quoted price to one exact user action, so the\n * exchange cannot pair it with a different deposit/withdrawal.\n */\nfunction encodeSettleApproval(kind: number, sharePrice: DecimalLike, hashLabel: string, hash: string): string {\n  if (!isHexString(hash, 32)) throw new Error(`${hashLabel} must be a 0x-prefixed 32-byte hex string`);\n  return abi.encode(['uint256', 'uint256', 'bytes32'], [kind, unsignedE18(sharePrice, 'sharePrice'), hash]);\n}\n","import { concat, getAddress, toBeHex, zeroPadValue } from 'ethers';\nimport type { ProtocolScopeCode } from '../auth/scopes';\n\nexport interface CreateSessionKeyData {\n  /** Address of the key being authorized. */\n  sessionKey: string;\n  /**\n   * The KEY's lifetime as a unix-seconds timestamp — distinct from the\n   * envelope's signature expiry. The key stops working once `expirySec <= now`;\n   * pass 0 to deactivate an existing key of this address.\n   */\n  expirySec: number;\n  /**\n   * Scope codes granted to the key (auth/scopes.ts). Typed as `number` at\n   * this low level so raw codes pass through — the typed\n   * `ProtocolScopeCode` enum guides callers, and the server is the\n   * authority on which codes are valid.\n   */\n  scopes: readonly (ProtocolScopeCode | number)[];\n  /** Subaccounts the key may act on; empty = ALL current and future subaccounts. */\n  subaccountIds: readonly (number | bigint)[];\n}\n\n/**\n * Encodes the create-session-key action data.\n *\n * Hand-packed 32-byte words — NOT standard dynamic ABI (no offset or\n * length-prefix head): `[session_key][expiry_sec][S][A][scope codes…]\n * [subaccount ids…]`, every value right-aligned in its word.\n */\nexport function encodeCreateSessionKeyActionData(data: CreateSessionKeyData): string {\n  if (!Number.isInteger(data.expirySec) || data.expirySec < 0) {\n    throw new Error(`session key expirySec must be a non-negative unix-seconds integer, got ${data.expirySec}`);\n  }\n  return concat([\n    zeroPadValue(getAddress(data.sessionKey), 32),\n    uintWord(data.expirySec),\n    uintWord(data.scopes.length),\n    uintWord(data.subaccountIds.length),\n    ...data.scopes.map((code) => uintWord(code)),\n    ...data.subaccountIds.map((id) => uintWord(id)),\n  ]);\n}\n\nfunction uintWord(value: number | bigint): string {\n  const valid = typeof value === 'bigint' ? value >= 0n : Number.isSafeInteger(value) && value >= 0;\n  if (!valid) throw new Error(`expected a non-negative integer, got ${value}`);\n  return zeroPadValue(toBeHex(value), 32);\n}\n","import { concat, getAddress, toBeHex, zeroPadValue } from 'ethers';\n\n/**\n * Whitelisted-recipient delta, verified by the whitelisted-recipient\n * module: the resulting list is `(current ∪ add) \\ remove`.\n */\nexport interface WhitelistedRecipientsFields {\n  add: string[];\n  remove: string[];\n}\n\n/**\n * Hand-packed layout (2 + A + R words), NOT standard ABI dynamic arrays:\n *   word 0     : add count A\n *   word 1     : remove count R\n *   word 2+i   : add[i]     (address, left-padded)\n *   word 2+A+j : remove[j]  (address, left-padded)\n */\nexport function encodeUpdateWhitelistedRecipients(fields: WhitelistedRecipientsFields): string {\n  const add = fields.add.map((a) => getAddress(a));\n  const remove = fields.remove.map((a) => getAddress(a));\n  return concat([\n    zeroPadValue(toBeHex(add.length), 32),\n    zeroPadValue(toBeHex(remove.length), 32),\n    ...add.map((a) => zeroPadValue(a, 32)),\n    ...remove.map((a) => zeroPadValue(a, 32)),\n  ]);\n}\n"],"mappings":"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","names":["import_ethers","assertE12Precision","import_ethers","import_ethers","import_ethers","import_ethers","import_ethers","import_ethers","uintWord","import_ethers"]}

package/dist/codecs/index.d.cts

@@ -0,0 +1,264 @@
+import { D as DecimalLike, P as ProtocolScopeCode } from '../scopes-RzGb3xH6.cjs';
+import { D as Direction } from '../generated-DwMaydIF.cjs';
+
+/**
+ * Inputs to the trade (order) action payload, verified by the trade
+ * module (`network.modules.trade`).
+ */
+interface TradeActionFields {
+    /** Protocol asset contract of the instrument (`base_asset_address`). */
+    assetAddress: string;
+    /** Asset sub id (`base_asset_sub_id`): 0 for perps/spot, the option id for options. */
+    subId: string | number | bigint;
+    limitPrice: DecimalLike;
+    amount: DecimalLike;
+    /** Worst acceptable fee per unit traded the signature allows. */
+    maxFee: DecimalLike;
+    /** Subaccount credited with the fill — the trading subaccount itself. */
+    recipientSubaccountId: number | bigint;
+    isBid: boolean;
+}
+/**
+ * Encodes the order action data: seven static words — asset, subId,
+ * limitPrice, amount, maxFee, recipientId, isBid — with
+ * prices/amounts/fee e18-scaled.
+ */
+declare function encodeTradeData(fields: TradeActionFields): string;
+
+/**
+ * Spot transfer between subaccounts of the same owner, verified by the
+ * transfer module. Position transfers are booked as RFQ trades — this
+ * action only ever moves a single spot asset.
+ */
+interface TransferFields {
+    toSubaccountId: number | bigint;
+    /**
+     * Routing sentinel: 0 credits the existing `toSubaccountId`; non-zero
+     * creates a new subaccount under this manager id instead (the
+     * destination id is then ignored).
+     */
+    newSubaccountManager: number | bigint;
+    /** Protocol spot-asset address (not the underlying ERC-20). */
+    asset: string;
+    subId: number | bigint;
+    /** Strictly positive; signed at e18. */
+    amount: DecimalLike;
+    /** Maximum fee the signer authorises, in USD; signed at e18. */
+    maxFeeUsd: DecimalLike;
+}
+/** ABI-encodes transfer action data: six static 32-byte words. */
+declare function encodeTransfer(fields: TransferFields): string;
+
+/**
+ * Spot transfer to another owner's wallet, verified by the external
+ * transfer module: the six transfer words plus a seventh holding the
+ * recipient wallet.
+ */
+interface ExternalTransferFields extends TransferFields {
+    /**
+     * Destination owner wallet. `toSubaccountId` must be one of its existing
+     * subaccounts, or 0 to create one for it under `newSubaccountManager`.
+     */
+    recipient: string;
+}
+/**
+ * All seven words are static, so the encoding is exactly the transfer
+ * payload with the recipient appended as a left-padded address word.
+ */
+declare function encodeExternalTransfer(fields: ExternalTransferFields): string;
+
+/** Withdrawal to L1, verified by the withdrawal module. */
+interface WithdrawalFields {
+    /** Protocol asset contract address (not the underlying ERC-20). */
+    protocolAsset: string;
+    /** Maximum fee the signer authorises, in USD; signed at e18 like every other action value. */
+    maxFeeUsd: DecimalLike;
+    /** L1 payout recipient. The exchange only constructs withdrawals paying out to the action signer. */
+    recipient: string;
+    /**
+     * Withdrawal amount in the ERC-20's NATIVE decimals (USDC = 6) — the
+     * protocol's only never-scaled amount, since it is the L1 payout value.
+     */
+    amount: DecimalLike;
+    /** The underlying ERC-20's decimals, used to scale `amount`. */
+    decimals: number;
+    /** Pay a higher fee for immediate batch proving. */
+    forceBatch: boolean;
+}
+/** ABI-encodes withdrawal action data: five static 32-byte words. */
+declare function encodeWithdrawal(fields: WithdrawalFields): string;
+
+/**
+ * RFQ action-data codecs.
+ *
+ * Maker and taker must hash byte-identical leg bundles: legs are sorted
+ * lexicographically by instrument name, and each signed leg amount is
+ * `amount × legDirectionSign × directionSign × perspectiveSign`. The maker
+ * encodes with their own quote direction (perspective +1); the taker
+ * executes with the opposite direction and perspective −1, which cancels
+ * back to the maker's exact values — the server rebuilds the taker's
+ * order hash from the maker's stored quote.
+ */
+/** A quoted leg carrying everything the signature commits to. */
+interface RfqSignedLeg {
+    /** Canonical ordering key — both sides sign legs sorted by this. */
+    instrumentName: string;
+    /** Protocol asset contract for the instrument (option or perp). */
+    assetAddress: string;
+    /** Asset sub id: '0' for perps, the option's encoded sub id otherwise. */
+    subId: string | bigint;
+    /** Per-unit price, always positive; e18-scaled into the signed bytes. */
+    price: DecimalLike;
+    /** Unsigned size — direction carries the sign. */
+    amount: DecimalLike;
+    direction: Direction;
+}
+interface RfqQuoteFields {
+    /** Worst fee the signer accepts, in USD; e18 in the signed bytes. */
+    maxFee: DecimalLike;
+    /** The maker's quote direction (taker execute: the taker's own direction). */
+    direction: Direction;
+    legs: RfqSignedLeg[];
+}
+/** Sorts legs into the canonical order both counterparties sign and send. */
+declare function sortRfqLegs<T extends {
+    instrumentName: string;
+}>(legs: readonly T[]): T[];
+/**
+ * Maker quote data: `abi.encode(RfqOrder{ maxFee, trades[] })` —
+ * `[0x20][maxFee][0x40][N][4 words per leg]`. Unlike the trade codec's
+ * low-16-byte i128 amount words, a negative leg amount here is a full
+ * sign-extended int256 (high 16 bytes 0xff), which is standard AbiCoder
+ * output.
+ */
+declare function encodeRfqQuote(fields: RfqQuoteFields): string;
+/**
+ * Taker execute data: `abi.encode(bytes32 orderHash, uint256 maxFee)` where
+ * `orderHash = keccak256(abi.encode(trades[]))` — the maker's legs only,
+ * maker maxFee excluded. `fields.direction` is the TAKER's direction
+ * (opposite of the quote's); `fields.maxFee` is the taker's own fee cap.
+ */
+declare function encodeRfqExecute(fields: RfqQuoteFields): string;
+
+/** Word-0 kind discriminators. */
+declare const VAULT_ACTION_KIND: {
+    readonly create: 0;
+    readonly deposit: 1;
+    readonly withdraw: 2;
+    readonly cancel: 3;
+    readonly mintShares: 4;
+    readonly burnShares: 5;
+};
+interface VaultDepositFields {
+    vaultSubaccountId: number | bigint;
+    /** Must equal the vault's configured deposit asset (protocol spot-asset address). */
+    depositSpotAsset: string;
+    /** Deposit amount in the deposit asset's units; max 12 decimal places. */
+    amount: DecimalLike;
+}
+/** VaultDepositData (kind = 1, 4 words): [kind, vaultSubaccountId, depositSpotAsset, amountE18]. */
+declare function encodeVaultDeposit(fields: VaultDepositFields): string;
+interface VaultWithdrawFields {
+    vaultSubaccountId: number | bigint;
+    /** Vault shares to redeem; max 12 decimal places. */
+    sharesToBurn: DecimalLike;
+}
+/** VaultWithdrawData (kind = 2, 3 words): [kind, vaultSubaccountId, sharesToBurnE18]. */
+declare function encodeVaultWithdraw(fields: VaultWithdrawFields): string;
+/**
+ * VaultCancelData (kind = 3, 2 words): [kind, vaultSubaccountId].
+ * Invalidates ALL of the signer's pending intents for the vault by
+ * bumping their per-(vault, holder) nonce to the envelope's nonce.
+ */
+declare function encodeVaultCancel(vaultSubaccountId: number | bigint): string;
+interface VaultCreateFields {
+    managerId: number;
+    depositSpotAsset: string;
+    /** Initial deposit moved funding subaccount → vault; max 12 decimal places. */
+    initialDeposit: DecimalLike;
+    managementFeeBps: number;
+    performanceFeeBps: number;
+    maxSlippageBps: number;
+    cooldownSec: number | bigint;
+    /** Maximum settlement fee authorised, in USD; max 12 decimal places. */
+    maxFeeUsd: DecimalLike;
+    /** Share price the vault is seeded at, in USD; max 12 decimal places. */
+    initialSharePriceUsd: DecimalLike;
+    /**
+     * Spot asset the high-water mark is denominated in. Omit for the
+     * feed-less USD default — presence drives the encoded hasBenchmark
+     * flag, exactly as the exchange derives it from the wire param.
+     */
+    benchmarkAsset?: string;
+}
+/**
+ * Create-vault action data (kind = 0, 12 words):
+ * [kind, managerId, depositSpotAsset, initialDepositE18,
+ *  managementFeeBps, performanceFeeBps, maxSlippageBps, cooldownSec,
+ *  maxFeeUsdE18, initialSharePriceUsdE18, benchmarkAsset, hasBenchmark].
+ * bps rates and cooldownSec are plain integers, not e18.
+ */
+declare function encodeVaultCreate(fields: VaultCreateFields): string;
+interface VaultMintSharesFields {
+    /** Quoted share price in USD per share; max 12 decimal places. */
+    sharePrice: DecimalLike;
+    /** keccak256 of the user's exact encoded deposit action (0x hex, 32 bytes). */
+    depositHash: string;
+}
+/** MintSharesActionData (kind = 4): the curator's approval to settle one queued deposit. */
+declare function encodeVaultMintShares(fields: VaultMintSharesFields): string;
+interface VaultBurnSharesFields {
+    /** Quoted share price in USD per share; max 12 decimal places. */
+    sharePrice: DecimalLike;
+    /** keccak256 of the user's exact encoded withdraw action (0x hex, 32 bytes). */
+    withdrawHash: string;
+}
+/** BurnSharesActionData (kind = 5): the curator's approval to settle one queued withdrawal. */
+declare function encodeVaultBurnShares(fields: VaultBurnSharesFields): string;
+
+interface CreateSessionKeyData {
+    /** Address of the key being authorized. */
+    sessionKey: string;
+    /**
+     * The KEY's lifetime as a unix-seconds timestamp — distinct from the
+     * envelope's signature expiry. The key stops working once `expirySec <= now`;
+     * pass 0 to deactivate an existing key of this address.
+     */
+    expirySec: number;
+    /**
+     * Scope codes granted to the key (auth/scopes.ts). Typed as `number` at
+     * this low level so raw codes pass through — the typed
+     * `ProtocolScopeCode` enum guides callers, and the server is the
+     * authority on which codes are valid.
+     */
+    scopes: readonly (ProtocolScopeCode | number)[];
+    /** Subaccounts the key may act on; empty = ALL current and future subaccounts. */
+    subaccountIds: readonly (number | bigint)[];
+}
+/**
+ * Encodes the create-session-key action data.
+ *
+ * Hand-packed 32-byte words — NOT standard dynamic ABI (no offset or
+ * length-prefix head): `[session_key][expiry_sec][S][A][scope codes…]
+ * [subaccount ids…]`, every value right-aligned in its word.
+ */
+declare function encodeCreateSessionKeyActionData(data: CreateSessionKeyData): string;
+
+/**
+ * Whitelisted-recipient delta, verified by the whitelisted-recipient
+ * module: the resulting list is `(current ∪ add) \ remove`.
+ */
+interface WhitelistedRecipientsFields {
+    add: string[];
+    remove: string[];
+}
+/**
+ * Hand-packed layout (2 + A + R words), NOT standard ABI dynamic arrays:
+ *   word 0     : add count A
+ *   word 1     : remove count R
+ *   word 2+i   : add[i]     (address, left-padded)
+ *   word 2+A+j : remove[j]  (address, left-padded)
+ */
+declare function encodeUpdateWhitelistedRecipients(fields: WhitelistedRecipientsFields): string;
+
+export { type CreateSessionKeyData, type ExternalTransferFields, type RfqQuoteFields, type RfqSignedLeg, type TradeActionFields, type TransferFields, VAULT_ACTION_KIND, type VaultBurnSharesFields, type VaultCreateFields, type VaultDepositFields, type VaultMintSharesFields, type VaultWithdrawFields, type WhitelistedRecipientsFields, type WithdrawalFields, encodeCreateSessionKeyActionData, encodeExternalTransfer, encodeRfqExecute, encodeRfqQuote, encodeTradeData, encodeTransfer, encodeUpdateWhitelistedRecipients, encodeVaultBurnShares, encodeVaultCancel, encodeVaultCreate, encodeVaultDeposit, encodeVaultMintShares, encodeVaultWithdraw, encodeWithdrawal, sortRfqLegs };