@continuumdao/ctm-mpc-defi 0.2.48 → 0.2.49

package/dist/protocols/evm/derive/index.d.ts

@@ -0,0 +1,859 @@
+import { TypedDataDomain, Hex, Address } from 'viem';
+
+/** Aligns with app NonEvmChainType + 'evm'. Extend as mpc-auth adds chains. */
+type ChainCategory = 'evm' | 'solana' | 'near' | 'sui' | 'ton' | 'stellar';
+type MultisignBuildResult = {
+    bodyForSign: Record<string, unknown>;
+    messageToSign: string;
+};
+type EvmTokenKind = 'native' | 'erc20' | 'erc721' | 'ctmerc20' | 'ctmrwa1';
+type SolanaTokenKind = 'native' | 'spl' | 'spl2022';
+type NearTokenKind = 'native' | 'nep141';
+type TokenRef = {
+    category: 'evm';
+    kind: EvmTokenKind;
+    address: `0x${string}`;
+} | {
+    category: 'solana';
+    kind: SolanaTokenKind;
+    mint: string;
+} | {
+    category: 'near';
+    kind: NearTokenKind;
+    contractId: string;
+};
+type ParamDoc = {
+    type: string;
+    required: boolean;
+    description: string;
+};
+type ProtocolActionDescriptor = {
+    id: string;
+    protocolId: string;
+    chainCategory: ChainCategory;
+    description: string;
+    commonParams: Array<'keyGen' | 'purposeText' | 'useCustomGas' | 'useCustomFees'>;
+    params: Record<string, ParamDoc>;
+};
+type ChainSupportContext = {
+    chainCategory: ChainCategory;
+    chainId: string | number;
+};
+interface ProtocolModule {
+    id: string;
+    chainCategory: ChainCategory;
+    isChainSupported(ctx: ChainSupportContext): boolean | Promise<boolean>;
+    isTokenSupported(token: TokenRef): boolean | Promise<boolean>;
+    actions: ProtocolActionDescriptor[];
+}
+type KeyGenSubset = {
+    pubkeyhex?: string;
+    keylist?: string[];
+    ClientKeys?: Record<string, string>;
+    groupId?: string;
+    GroupId?: string;
+};
+/** App-compatible alias used by multisign builders and Permit2 helpers. */
+type KeyGenSubsetForPermit = KeyGenSubset;
+
+declare const DERIVE_PROTOCOL_ID: "derive";
+declare const DERIVE_MATCHING_VERIFYING_CONTRACT: "0xeB8d770ec18DB98Db922E9D83260A585b9F0DeAD";
+/** keccak256("Action(uint256 subaccountId,uint256 nonce,address module,bytes data,uint256 expiry,address owner,address signer)") */
+declare const DERIVE_ACTION_TYPEHASH: "0x4d7a9f27c403ff9c0f19bce61d76d82f9aa29f8d6d4b0c5474607d9770d1af17";
+declare const DERIVE_TRADE_MODULE: "0xB8D20c2B7a1Ad2EE33Bc50eF10876eD3035b5e7b";
+declare const DERIVE_TRANSFER_MODULE: "0x01259207A40925b794C8ac320456F7F6c8FE2636";
+declare const DERIVE_DOMAIN_SEPARATOR_MAINNET: "0xda616dfabb88681b08e1592820a41d55ddc62d68de110e327ae99d734506fe19";
+declare const DERIVE_DOMAIN_SEPARATOR_TESTNET: "0x24d674cd5f2b9d564691c51e9d88f649b99246a2244dd74ce27b96578d773e85";
+declare const DERIVE_MAINNET_API = "https://api.derive.xyz/v3";
+declare const DERIVE_TESTNET_API = "https://testnet.api.derive.xyz/v3";
+/** Live production REST. v3 mainnet currently ‑32603s catalog methods that still work here. */
+declare const DERIVE_MAINNET_API_V2 = "https://api.lyra.finance";
+declare const DERIVE_TESTNET_API_V2 = "https://api-demo.lyra.finance";
+/** Sepolia OnchainActionManager. Mainnet is still unpublished — override via env or builder arg. */
+declare const DERIVE_ACTION_MANAGER_TESTNET: "0xd3625eCf97E5554C62A48Ac1c9284C9dCeFceB68";
+declare const DERIVE_EIP712_NAME = "Matching";
+declare const DERIVE_EIP712_VERSION = "1.0";
+declare const DERIVE_DEFAULT_SIGNATURE_EXPIRY_SEC = 300;
+declare const DERIVE_MIN_ORDER_EXPIRY_SEC = 10;
+declare const DERIVE_OHLCV_INTERVALS: readonly ["1m", "5m", "15m", "30m", "1h", "4h", "1d", "1w"];
+type DeriveOhlcvInterval = (typeof DERIVE_OHLCV_INTERVALS)[number];
+declare const DERIVE_OHLCV_PERIOD_SEC: Record<DeriveOhlcvInterval, number>;
+declare const DERIVE_DEFAULT_OHLCV_INTERVAL: DeriveOhlcvInterval;
+/** Default window when the caller omits lookback — enough for a dialog chart, not a full history dump. */
+declare const DERIVE_DEFAULT_OHLCV_BARS = 96;
+/** Default strike/premium ladder: ATM window, same width as the Trade-tab table. */
+declare const DERIVE_DEFAULT_TICKER_ATM_STRIKES = 9;
+declare const DERIVE_DEFAULT_LOOKBACK_DAYS = 2;
+declare const DERIVE_MAX_LOOKBACK_DAYS = 90;
+declare const DERIVE_MAX_OHLCV_BARS = 2000;
+declare const DERIVE_UNFUNDED_NOTES = "No Derive subaccount on this KeyGen. Fund from a logo row: Ethereum L1 USDC/WETH/WBTC (ctm_derive_build_deposit_new_subaccount_multisign or register_deposit_address + transfer), Socket USDC/WETH/WBTC on Optimism/Base/Arbitrum (ctm_derive_build_socket_deposit_multisign), or HyperEVM HYPE (ctm_derive_build_hype_vault_deposit_multisign). After credit, EIP-712 orders use Derive collateral.";
+declare const DERIVE_UNFUNDED_NEXT: readonly ["ctm_derive_fetch_risk_universes", "ctm_derive_build_deposit_new_subaccount_multisign", "ctm_derive_register_deposit_address", "ctm_derive_build_socket_deposit_multisign", "ctm_derive_build_hype_vault_deposit_multisign"];
+declare const DERIVE_MISSING_SUBACCOUNT_ERROR = "subaccountId is required and must come from ctm_derive_fetch_subaccounts. If that list is empty, fund from a Derive logo row (Ethereum L1, Socket on OP/Base/Arb, or HyperEVM HYPE). Do not use subaccount_id 0 for orders.";
+
+/** Settlement chain for EIP-712 domain + Direct deposit. */
+declare const DERIVE_SETTLEMENT_CHAIN_IDS: readonly [1, 11155111];
+type DeriveNetwork = 'mainnet' | 'testnet';
+declare function deriveNetworkFromChainId(chainId: number): DeriveNetwork;
+declare function deriveSettlementChainId(network: DeriveNetwork): number;
+declare function deriveApiBaseUrl(network?: DeriveNetwork): string;
+/** Production REST used when v3 public catalog methods ‑32603 / 404 / return empty. */
+declare function deriveApiFallbackBaseUrl(network?: DeriveNetwork): string;
+declare function deriveApiBaseUrlForChainId(chainId: number): string;
+declare function deriveActionManagerAddress(chainId: number, override?: string): `0x${string}`;
+declare function isDeriveSettlementChainId(chainId: number): boolean;
+/**
+ * Asset-row chains that can actually fund Derive (Hyperliquid-shaped).
+ * Ethereum L1 direct / deposit-address, Socket on OP/Base/Arb, HYPE vault on HyperEVM.
+ */
+declare const DERIVE_ASSET_ROW_CHAIN_IDS: readonly [1, 10, 8453, 42161, 999, 11155111];
+declare function isDeriveAssetRowChainId(chainId: number): boolean;
+declare function isDeriveChainSupported(chainId: number): boolean;
+declare const NATIVE_ZERO: "0x0000000000000000000000000000000000000000";
+type TokenRow = {
+    address: `0x${string}`;
+    symbol: string;
+    decimals: number;
+    roles: string[];
+};
+/** Per-chain token rows that can fund Derive (Socket / L1 / HYPE vault). */
+declare function deriveMappedTokensForChain(chainId: number): TokenRow[];
+declare function deriveNativeWrappedForChain(chainId: number): string | undefined;
+declare function deriveAdvisorNotes(): string;
+
+/** Map a node asset-row address to the Derive advisor lookup key (native gas → wrapped). */
+declare function deriveKeyForNodeAssetRow(args: {
+    contractAddress: string;
+    nativeWrapped?: string | null;
+}): string | null;
+
+type DeriveAuth = {
+    wallet: string;
+    timestamp: string;
+    signature: string;
+};
+type DeriveRpcError = {
+    code?: number;
+    message?: string;
+    data?: unknown;
+};
+declare function isDerivePublicMethod(method: string): boolean;
+declare function isEmptyDerivePublicResult(method: string, result: unknown): boolean;
+declare function isDeriveRecoverablePublicError(err: unknown): boolean;
+declare function deriveRpc<T>(args: {
+    method: string;
+    params?: Record<string, unknown>;
+    network?: DeriveNetwork;
+    auth?: DeriveAuth;
+}): Promise<T>;
+declare function requireDeriveAuth(auth: DeriveAuth | undefined, toolHint: string): DeriveAuth;
+
+type DeriveInstrument = {
+    instrument_name: string;
+    instrument_type?: string;
+    base_asset_address?: string;
+    base_asset_sub_id?: string;
+    is_active?: boolean;
+    option_details?: {
+        expiry?: number;
+        strike?: string;
+        option_type?: string;
+    };
+    [key: string]: unknown;
+};
+type DeriveCurrencyManager = {
+    address?: string;
+    margin_type?: string;
+    currency?: string | null;
+    manager_id?: number;
+};
+type DeriveCurrency = {
+    currency: string;
+    instrument_types?: string[];
+    protocol_asset_addresses?: {
+        option?: string | null;
+        perp?: string | null;
+        spot?: string | null;
+        underlying_erc20?: string | null;
+    };
+    managers?: DeriveCurrencyManager[];
+    spot?: Array<{
+        erc20?: {
+            underlying_erc20?: string;
+            decimals?: number;
+        };
+    }>;
+    [key: string]: unknown;
+};
+declare function deriveFetchInstrument(args: {
+    instrumentName: string;
+    network?: DeriveNetwork;
+}): Promise<DeriveInstrument>;
+declare function deriveFetchCurrenciesRaw(args?: {
+    network?: DeriveNetwork;
+}): Promise<DeriveCurrency[]>;
+declare function deriveFetchOptionInstruments(args: {
+    currency: string;
+    expired?: boolean;
+    page?: number;
+    pageSize?: number;
+    network?: DeriveNetwork;
+}): Promise<{
+    instruments: DeriveInstrument[];
+}>;
+declare function deriveSearchInstruments(instruments: DeriveInstrument[], query: string, limit?: number): DeriveInstrument[];
+
+type DeriveOhlcvCandle = {
+    timestampMs: number;
+    open: string;
+    high: string;
+    low: string;
+    close: string;
+    volume: string;
+};
+declare function resolveDeriveOhlcvWindow(args: {
+    interval: DeriveOhlcvInterval;
+    lookbackDays?: number;
+    lookbackHours?: number;
+    startTimeMs?: number;
+    endTimeMs?: number;
+}): {
+    startTimeMs: number;
+    endTimeMs: number;
+    expectedBars: number;
+    periodSec: number;
+};
+declare function mapDeriveTradingviewCandles(raw: unknown): DeriveOhlcvCandle[];
+type DeriveOptionType = 'C' | 'P';
+type DeriveParsedInstrumentName = {
+    currency: string;
+    expiryYmd: string;
+    strike: string;
+    optionType: DeriveOptionType;
+};
+declare function deriveParseInstrumentName(name: string): DeriveParsedInstrumentName | null;
+declare function deriveExpiryUnixToYmd(expirySec: number): string;
+type DeriveTickerQuote = {
+    instrumentName: string;
+    bidPx: string | null;
+    askPx: string | null;
+    markPx: string | null;
+    indexPx: string | null;
+    strike: string | null;
+    expiry: number | null;
+    expiryYmd: string | null;
+    optionType: DeriveOptionType | null;
+    greeks: Record<string, unknown> | null;
+};
+declare function mapDeriveTickerRow(raw: unknown): DeriveTickerQuote | null;
+declare function collectDeriveTickerRows(raw: unknown): unknown[];
+declare function normalizeDeriveExpiryYmd(raw: unknown): string;
+declare function deriveAtmTickerWindow(tickers: DeriveTickerQuote[], maxStrikes?: number): DeriveTickerQuote[];
+declare function deriveFetchTickersSummary(args: {
+    chainId?: number;
+    network?: DeriveNetwork;
+    currency: string;
+    expiryDate: string | number;
+    optionType?: DeriveOptionType;
+    ladder?: 'atm' | 'all';
+}): Promise<{
+    currency: string;
+    expiryDate: string;
+    optionType: DeriveOptionType | null;
+    ladder: "atm" | "all";
+    indexPx: string | null;
+    listedCount: number;
+    tickerCount: number;
+    callCount: number;
+    putCount: number;
+    tickers: DeriveTickerQuote[];
+    notes: string;
+    network: DeriveNetwork;
+}>;
+type DeriveOrderBookLevel = {
+    price: string;
+    amount: string;
+};
+declare function mapDeriveOrderBookLevels(raw: unknown): DeriveOrderBookLevel[];
+declare function deriveFetchOrderBookSummary(args: {
+    chainId?: number;
+    network?: DeriveNetwork;
+    instrumentName: string;
+    depth?: number;
+}): Promise<{
+    instrumentName: string;
+    bids: DeriveOrderBookLevel[];
+    asks: DeriveOrderBookLevel[];
+    network: DeriveNetwork;
+}>;
+declare function deriveFetchCurrenciesSummary(args: {
+    chainId?: number;
+    network?: DeriveNetwork;
+}): Promise<{
+    currencies: {
+        currency: string;
+    }[];
+    network: DeriveNetwork;
+}>;
+type DeriveMappedOptionInstrument = {
+    instrumentName: string;
+    instrumentType: string;
+    isActive: boolean;
+    strike: string | null;
+    expiry: number | null;
+    optionType: string | null;
+};
+type DeriveOptionExpirySummary = {
+    expiryYmd: string;
+    expiryUnix: number | null;
+    callCount: number;
+    putCount: number;
+    minStrike: string | null;
+    maxStrike: string | null;
+};
+declare function summarizeDeriveOptionChain(args: {
+    currency: string;
+    instruments: DeriveMappedOptionInstrument[];
+}): {
+    currency: string;
+    instrumentCount: number;
+    callCount: number;
+    putCount: number;
+    expiries: DeriveOptionExpirySummary[];
+};
+declare function deriveFetchOptionChainSummary(args: {
+    chainId?: number;
+    network?: DeriveNetwork;
+    currency: string;
+    expired?: boolean;
+}): Promise<{
+    currency: string;
+    instruments: {
+        instrumentName: string;
+        instrumentType: string;
+        isActive: boolean;
+        strike: string | null;
+        expiry: number | null;
+        optionType: DeriveOptionType | null;
+    }[];
+    network: DeriveNetwork;
+}>;
+/** Compact expiry ladder for the agent — do not dump every instrument (offloads + bash). */
+declare function deriveFetchOptionChainAgentSummary(args: {
+    chainId?: number;
+    network?: DeriveNetwork;
+    currency: string;
+    expired?: boolean;
+}): Promise<{
+    notes: string;
+    network: DeriveNetwork;
+    currency: string;
+    instrumentCount: number;
+    callCount: number;
+    putCount: number;
+    expiries: DeriveOptionExpirySummary[];
+}>;
+declare function deriveSearchInstrumentsSummary(args: {
+    chainId?: number;
+    network?: DeriveNetwork;
+    currency: string;
+    query: string;
+    limit?: number;
+}): Promise<{
+    instruments: {
+        instrumentName: string;
+    }[];
+    network: DeriveNetwork;
+}>;
+declare function deriveFetchMarketSnapshotSummary(args: {
+    chainId?: number;
+    network?: DeriveNetwork;
+    instrumentName: string;
+}): Promise<{
+    snapshot: {
+        instrumentName: string;
+        livePrice: {
+            markPx: string | null;
+            indexPx: string | null;
+            bidPx: string | null;
+            askPx: string | null;
+            midUsd: string;
+            source: string;
+        };
+        greeks: {} | null;
+        fetchedAtMs: number;
+    };
+    network: DeriveNetwork;
+}>;
+declare function deriveFetchOhlcvSummary(args: {
+    chainId?: number;
+    network?: DeriveNetwork;
+    instrumentName?: string;
+    currency?: string;
+    marketKind?: 'option' | 'index';
+    interval?: string;
+    lookbackDays?: number;
+    lookbackHours?: number;
+    startTimeMs?: number;
+    endTimeMs?: number;
+}): Promise<{
+    ohlcv: {
+        market: string;
+        coin: string;
+        interval: "1m" | "5m" | "15m" | "30m" | "1h" | "4h" | "1d" | "1w";
+        marketKind: "option" | "index";
+        startTimeMs: number;
+        endTimeMs: number;
+        expectedBars: number;
+        candleCount: number;
+        latestCandle: DeriveOhlcvCandle;
+        candles: DeriveOhlcvCandle[];
+        fetchedAtMs: number;
+        dataSource: "derive";
+    };
+    dataSource: "derive";
+    network: DeriveNetwork;
+}>;
+declare function deriveOrderQuoteSummary(args: {
+    chainId?: number;
+    network?: DeriveNetwork;
+    instrumentName: string;
+    direction: 'buy' | 'sell';
+    amount: string;
+    limitPrice: string;
+    subaccountId?: number;
+}): Promise<{
+    quote: Record<string, unknown>;
+    instrumentName: string;
+    network: DeriveNetwork;
+}>;
+declare function synthesizeDeriveRiskUniversesFromCurrencies(currencies: DeriveCurrency[]): {
+    risk_universe_id: null;
+    source: string;
+    managers: {
+        manager_id: number | null;
+        address: string;
+        margin_type: string | null;
+        currency: string | null;
+        instrument_types: string[];
+        collaterals: Array<{
+            name: string;
+            address: string | null;
+            erc20: {
+                underlying_erc20: string | null;
+            };
+        }>;
+    }[];
+}[];
+declare function deriveFetchRiskUniversesSummary(args: {
+    chainId?: number;
+    network?: DeriveNetwork;
+}): Promise<{
+    universes: any[];
+    notes: string;
+    network: DeriveNetwork;
+}>;
+declare function deriveFetchPendingDepositsSummary(args: {
+    chainId?: number;
+    network?: DeriveNetwork;
+    wallet?: string;
+    executorAddress?: string;
+}): Promise<{
+    pending: any[];
+    credited: boolean;
+    notes: string;
+    network: DeriveNetwork;
+}>;
+
+declare function deriveEmptySubaccountsPayload(wallet: string): {
+    wallet: string;
+    subaccounts: number[];
+    funded: false;
+    notes: string;
+    next: ("ctm_derive_fetch_risk_universes" | "ctm_derive_build_deposit_new_subaccount_multisign" | "ctm_derive_register_deposit_address" | "ctm_derive_build_socket_deposit_multisign" | "ctm_derive_build_hype_vault_deposit_multisign")[];
+};
+declare function deriveFetchSubaccountsSummary(args: {
+    chainId?: number;
+    network?: DeriveNetwork;
+    wallet?: string;
+    executorAddress?: string;
+    auth?: DeriveAuth;
+}): Promise<{
+    network: DeriveNetwork;
+    wallet: string;
+    subaccounts: number[];
+    funded: false;
+    notes: string;
+    next: ("ctm_derive_fetch_risk_universes" | "ctm_derive_build_deposit_new_subaccount_multisign" | "ctm_derive_register_deposit_address" | "ctm_derive_build_socket_deposit_multisign" | "ctm_derive_build_hype_vault_deposit_multisign")[];
+} | {
+    wallet: `0x${string}`;
+    subaccounts: number[];
+    funded: true;
+    notes: string;
+    next: string[];
+    network: DeriveNetwork;
+}>;
+declare function deriveFetchPortfolioSummary(args: {
+    chainId?: number;
+    network?: DeriveNetwork;
+    wallet?: string;
+    executorAddress?: string;
+    subaccountId: number;
+    auth?: DeriveAuth;
+}): Promise<{
+    portfolio: unknown;
+    subaccountId: number;
+    wallet: `0x${string}`;
+    network: DeriveNetwork;
+}>;
+declare function deriveFetchPositionsSummary(args: {
+    chainId?: number;
+    network?: DeriveNetwork;
+    wallet?: string;
+    executorAddress?: string;
+    subaccountId: number;
+    auth?: DeriveAuth;
+}): Promise<{
+    positions: unknown[];
+    subaccountId: number;
+    wallet: `0x${string}`;
+    network: DeriveNetwork;
+}>;
+declare function deriveFetchOpenOrdersSummary(args: {
+    chainId?: number;
+    network?: DeriveNetwork;
+    wallet?: string;
+    executorAddress?: string;
+    subaccountId: number;
+    auth?: DeriveAuth;
+}): Promise<{
+    orders: unknown[];
+    subaccountId: number;
+    wallet: `0x${string}`;
+    network: DeriveNetwork;
+}>;
+
+type Eip712TypedDataField = {
+    name: string;
+    type: string;
+};
+type Eip712TypedDataPayload = {
+    domain: TypedDataDomain;
+    types: Record<string, readonly Eip712TypedDataField[] | Eip712TypedDataField[]>;
+    primaryType: string;
+    message: Record<string, unknown>;
+};
+
+declare const DERIVE_ACTION_TYPES: {
+    readonly Action: readonly [{
+        readonly name: "subaccountId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "nonce";
+        readonly type: "uint256";
+    }, {
+        readonly name: "module";
+        readonly type: "address";
+    }, {
+        readonly name: "data";
+        readonly type: "bytes";
+    }, {
+        readonly name: "expiry";
+        readonly type: "uint256";
+    }, {
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "signer";
+        readonly type: "address";
+    }];
+};
+declare function deriveE18(value: string, field: string): bigint;
+/** UTC-nanosecond nonce as a decimal string (ms * 1e6 + random 6 digits). */
+declare function deriveRandomNonce(nowMs?: number): string;
+declare function deriveExpirySec(secondsFromNow?: number, nowMs?: number): number;
+declare function deriveMatchingDomain(network: DeriveNetwork): {
+    name: string;
+    version: string;
+    chainId: bigint;
+    verifyingContract: Address;
+};
+declare function deriveDomainSeparator(network: DeriveNetwork): Hex;
+declare function encodeDeriveTradeData(args: {
+    assetAddress: string;
+    subId: string | number | bigint;
+    limitPrice: string;
+    amount: string;
+    maxFee: string;
+    recipientSubaccountId: number | bigint;
+    isBid: boolean;
+}): Hex;
+declare function encodeDeriveTransferData(args: {
+    toSubaccountId: number | bigint;
+    newSubaccountManager: number | bigint;
+    asset: string;
+    subId: number | bigint;
+    amount: string;
+    maxFeeUsd: string;
+}): Hex;
+declare function deriveActionTypehash(): Hex;
+declare function buildDeriveActionTypedData(args: {
+    network: DeriveNetwork;
+    subaccountId: number | bigint;
+    nonce: string;
+    module: string;
+    data: Hex;
+    expirySec: number;
+    owner: string;
+    signer: string;
+}): Eip712TypedDataPayload;
+declare function hashDeriveAction(args: Parameters<typeof buildDeriveActionTypedData>[0]): Hex;
+declare function assertPositiveSubaccountId(subaccountId: number | bigint | undefined): bigint;
+
+/** Millisecond UTC timestamp string Derive expects for EIP-191 login. */
+declare function deriveLoginTimestamp(nowMs?: number): string;
+/** Message text for `personal_sign` — the timestamp itself. */
+declare function deriveLoginMessage(timestampMs: string): string;
+declare function deriveLoginDigest(timestampMs: string): `0x${string}`;
+declare function deriveAuthHeaders(auth: DeriveAuth): Record<string, string>;
+
+type DeriveOrderDirection = 'buy' | 'sell';
+type DeriveOrderType = 'limit' | 'market';
+type DeriveTimeInForce = 'gtc' | 'ioc' | 'fok' | 'post_only';
+type DeriveTriggerType = 'stoploss' | 'takeprofit';
+type DeriveTriggerPriceType = 'mark' | 'index';
+type DeriveTicketKind = 'limit' | 'stop_limit' | 'twap';
+type DeriveExchangeCommon = {
+    keyGen: KeyGenSubsetForPermit;
+    chainId: number;
+    purposeText: string;
+    executorAddress: string;
+    subaccountId: number;
+    expiryDate?: number;
+    nonce?: string;
+    signatureExpirySec?: number;
+};
+type DerivePlaceOrderMultisignArgs = DeriveExchangeCommon & {
+    instrumentName: string;
+    direction: DeriveOrderDirection;
+    amount: string;
+    limitPrice: string;
+    maxFee: string;
+    orderType?: DeriveOrderType;
+    timeInForce?: DeriveTimeInForce;
+    reduceOnly?: boolean;
+    label?: string;
+    ticketKind?: DeriveTicketKind;
+    triggerPrice?: string;
+    triggerType?: DeriveTriggerType;
+    triggerPriceType?: DeriveTriggerPriceType;
+    algoDurationSec?: number;
+    algoNumSlices?: number;
+};
+type DeriveReplaceOrderMultisignArgs = DerivePlaceOrderMultisignArgs & {
+    orderIdToCancel?: string;
+    nonceToCancel?: string;
+};
+type DeriveCancelMultisignArgs = {
+    keyGen: KeyGenSubsetForPermit;
+    chainId: number;
+    purposeText: string;
+    executorAddress: string;
+    subaccountId: number;
+    instrumentName: string;
+    orderId: string;
+    expiryDate?: number;
+};
+declare function buildDerivePlaceOrderMultisign(args: DerivePlaceOrderMultisignArgs): Promise<MultisignBuildResult>;
+declare function buildDeriveReplaceOrderMultisign(args: DeriveReplaceOrderMultisignArgs): Promise<MultisignBuildResult>;
+/**
+ * v3 `private/cancel` is session-auth only (no Action module). Sign EIP-191 login
+ * so the node can POST with X-Derive* headers plus instrument/order/subaccount.
+ */
+declare function buildDeriveCancelMultisign(args: DeriveCancelMultisignArgs): MultisignBuildResult;
+
+type ChainRow$3 = {
+    legacy?: boolean;
+    gasLimit?: number;
+    gasMultiplier?: number;
+    gasPrice?: number;
+    baseFee?: number;
+    priorityFee?: number;
+    baseFeeMultiplier?: number;
+};
+type DeriveDepositNewSubaccountArgs = {
+    keyGen: KeyGenSubsetForPermit;
+    chainId: number;
+    rpcUrl: string;
+    chainDetail: ChainRow$3;
+    useCustomGas: boolean;
+    customGasChainDetails?: Record<string, unknown> | null;
+    executorAddress: Address | string;
+    purposeText: string;
+    /** Protocol-asset address from risk-universe collaterals[].address (not the row-chain token). */
+    protocolAsset: string;
+    /** Underlying ERC-20 to approve (`collaterals[].erc20.underlying_erc20`) on Ethereum L1. */
+    underlyingErc20: string;
+    amountHuman: string;
+    managerId: number;
+    actionManager?: string;
+    expiryDate?: number;
+};
+declare function buildDeriveDepositNewSubaccountMultisign(args: DeriveDepositNewSubaccountArgs): Promise<MultisignBuildResult>;
+
+type ChainRow$2 = {
+    legacy?: boolean;
+    gasLimit?: number;
+    gasMultiplier?: number;
+    gasPrice?: number;
+    baseFee?: number;
+    priorityFee?: number;
+    baseFeeMultiplier?: number;
+};
+declare function deriveRegisterDepositAddress(args: {
+    wallet: string;
+    managerId?: number;
+    subaccountId?: number;
+    chainId?: number;
+    network?: DeriveNetwork;
+}): Promise<{
+    depositAddress: string;
+    wallet: string;
+    managerId: number | null;
+    subaccountId: number | null;
+    network: DeriveNetwork;
+    notes: string;
+}>;
+declare function buildDeriveDepositAddressTransferMultisign(args: {
+    keyGen: KeyGenSubsetForPermit;
+    chainId: number;
+    rpcUrl: string;
+    chainDetail: ChainRow$2;
+    useCustomGas: boolean;
+    customGasChainDetails?: Record<string, unknown> | null;
+    executorAddress: Address | string;
+    purposeText: string;
+    underlyingErc20: string;
+    amountHuman: string;
+    depositAddress: string;
+    expiryDate?: number;
+}): Promise<MultisignBuildResult>;
+
+/** Socket SuperBridge destination — Derive Chain. Users never switch Continuum Assets to this id. */
+declare const DERIVE_SOCKET_APP_CHAIN_ID = 957;
+declare const DERIVE_SOCKET_CHAIN_IDS: readonly [1, 10, 8453, 42161];
+declare const DERIVE_HYPE_CHAIN_ID = 999;
+declare const DERIVE_WHYPE: "0x5555555555555555555555555555555555555555";
+/** HyperEVM vault that escrows wHYPE for Derive margin. Override with DERIVE_HYPE_VAULT. */
+declare const DERIVE_HYPE_VAULT_DEFAULT: "0xb792F94Ed56eD0bA163e5Ba139e2Bd0029A81d0a";
+declare const DERIVE_SOCKET_MSG_GAS_LIMIT = 500000n;
+declare const DERIVE_SOCKET_FEE_FALLBACK_WEI = 2000000000000000n;
+type DeriveSocketRoute = {
+    chainId: number;
+    symbol: string;
+    token: `0x${string}`;
+    vault: `0x${string}`;
+    connector: `0x${string}`;
+    decimals: number;
+};
+declare function isDeriveSocketChainId(chainId: number): boolean;
+declare function deriveHypeVaultAddress(override?: string): `0x${string}`;
+declare function deriveSocketRouteForToken(chainId: number, token: string): DeriveSocketRoute | null;
+declare function deriveSocketWethRoute(chainId: number): DeriveSocketRoute | null;
+type DeriveFundKind = 'l1_direct' | 'socket' | 'hype_vault';
+type DeriveFundRoute = {
+    kind: DeriveFundKind;
+    chainId: number;
+    symbol: string;
+    token: `0x${string}`;
+    decimals: number;
+    native: boolean;
+    socket?: DeriveSocketRoute;
+};
+/** Resolve a Continuum asset row to a deposit path. Native gas maps to WETH (Socket) or HYPE (HyperEVM). */
+declare function deriveFundRouteForAssetRow(args: {
+    chainId: number;
+    contractAddress: string;
+}): DeriveFundRoute | null;
+declare function deriveFundableTokensForChain(chainId: number): Array<{
+    address: `0x${string}`;
+    symbol: string;
+    decimals: number;
+    roles: string[];
+}>;
+
+type ChainRow$1 = {
+    legacy?: boolean;
+    gasLimit?: number;
+    gasMultiplier?: number;
+    gasPrice?: number;
+    baseFee?: number;
+    priorityFee?: number;
+    baseFeeMultiplier?: number;
+};
+type DeriveSocketDepositArgs = {
+    keyGen: KeyGenSubsetForPermit;
+    chainId: number;
+    rpcUrl: string;
+    chainDetail: ChainRow$1;
+    useCustomGas: boolean;
+    customGasChainDetails?: Record<string, unknown> | null;
+    executorAddress: Address | string;
+    purposeText: string;
+    /** Row token; native 0x0 wraps to WETH then bridges. */
+    token: string;
+    amountHuman: string;
+    /** Receiver on Derive Chain — same KeyGen EOA. Defaults to executor. */
+    receiver?: string;
+    expiryDate?: number;
+};
+declare function buildDeriveSocketDepositMultisign(args: DeriveSocketDepositArgs): Promise<MultisignBuildResult>;
+
+type ChainRow = {
+    legacy?: boolean;
+    gasLimit?: number;
+    gasMultiplier?: number;
+    gasPrice?: number;
+    baseFee?: number;
+    priorityFee?: number;
+    baseFeeMultiplier?: number;
+};
+type DeriveHypeVaultDepositArgs = {
+    keyGen: KeyGenSubsetForPermit;
+    chainId: number;
+    rpcUrl: string;
+    chainDetail: ChainRow;
+    useCustomGas: boolean;
+    customGasChainDetails?: Record<string, unknown> | null;
+    executorAddress: Address | string;
+    purposeText: string;
+    amountHuman: string;
+    /** Native 0x0 wraps first; WHYPE skips wrap. */
+    token?: string;
+    vault?: string;
+    expiryDate?: number;
+};
+declare function buildDeriveHypeVaultDepositMultisign(args: DeriveHypeVaultDepositArgs): Promise<MultisignBuildResult>;
+
+type DeriveTransferSpotMultisignArgs = {
+    keyGen: KeyGenSubsetForPermit;
+    chainId: number;
+    purposeText: string;
+    executorAddress: string;
+    /** Funded source subaccount (must already exist). */
+    fromSubaccountId: number;
+    /** 0 when creating an extra subaccount via newSubaccountManager. */
+    toSubaccountId: number;
+    newSubaccountManager: number;
+    asset: string;
+    amount: string;
+    maxFeeUsd?: string;
+    subId?: number;
+    expiryDate?: number;
+    nonce?: string;
+    signatureExpirySec?: number;
+};
+declare function buildDeriveTransferSpotMultisign(args: DeriveTransferSpotMultisignArgs): Promise<MultisignBuildResult>;
+
+declare const deriveProtocolModule: ProtocolModule;
+
+export { DERIVE_ACTION_MANAGER_TESTNET, DERIVE_ACTION_TYPEHASH, DERIVE_ACTION_TYPES, DERIVE_ASSET_ROW_CHAIN_IDS, DERIVE_DEFAULT_LOOKBACK_DAYS, DERIVE_DEFAULT_OHLCV_BARS, DERIVE_DEFAULT_OHLCV_INTERVAL, DERIVE_DEFAULT_SIGNATURE_EXPIRY_SEC, DERIVE_DEFAULT_TICKER_ATM_STRIKES, DERIVE_DOMAIN_SEPARATOR_MAINNET, DERIVE_DOMAIN_SEPARATOR_TESTNET, DERIVE_EIP712_NAME, DERIVE_EIP712_VERSION, DERIVE_HYPE_CHAIN_ID, DERIVE_HYPE_VAULT_DEFAULT, DERIVE_MAINNET_API, DERIVE_MAINNET_API_V2, DERIVE_MATCHING_VERIFYING_CONTRACT, DERIVE_MAX_LOOKBACK_DAYS, DERIVE_MAX_OHLCV_BARS, DERIVE_MIN_ORDER_EXPIRY_SEC, DERIVE_MISSING_SUBACCOUNT_ERROR, DERIVE_OHLCV_INTERVALS, DERIVE_OHLCV_PERIOD_SEC, DERIVE_PROTOCOL_ID, DERIVE_SETTLEMENT_CHAIN_IDS, DERIVE_SOCKET_APP_CHAIN_ID, DERIVE_SOCKET_CHAIN_IDS, DERIVE_SOCKET_FEE_FALLBACK_WEI, DERIVE_SOCKET_MSG_GAS_LIMIT, DERIVE_TESTNET_API, DERIVE_TESTNET_API_V2, DERIVE_TRADE_MODULE, DERIVE_TRANSFER_MODULE, DERIVE_UNFUNDED_NEXT, DERIVE_UNFUNDED_NOTES, DERIVE_WHYPE, type DeriveAuth, type DeriveCancelMultisignArgs, type DeriveCurrency, type DeriveCurrencyManager, type DeriveDepositNewSubaccountArgs, type DeriveFundKind, type DeriveFundRoute, type DeriveHypeVaultDepositArgs, type DeriveInstrument, type DeriveMappedOptionInstrument, type DeriveNetwork, type DeriveOhlcvCandle, type DeriveOhlcvInterval, type DeriveOptionExpirySummary, type DeriveOptionType, type DeriveOrderBookLevel, type DeriveOrderDirection, type DeriveOrderType, type DeriveParsedInstrumentName, type DerivePlaceOrderMultisignArgs, type DeriveReplaceOrderMultisignArgs, type DeriveRpcError, type DeriveSocketDepositArgs, type DeriveSocketRoute, type DeriveTickerQuote, type DeriveTicketKind, type DeriveTimeInForce, type DeriveTransferSpotMultisignArgs, type DeriveTriggerPriceType, type DeriveTriggerType, NATIVE_ZERO, assertPositiveSubaccountId, buildDeriveActionTypedData, buildDeriveCancelMultisign, buildDeriveDepositAddressTransferMultisign, buildDeriveDepositNewSubaccountMultisign, buildDeriveHypeVaultDepositMultisign, buildDerivePlaceOrderMultisign, buildDeriveReplaceOrderMultisign, buildDeriveSocketDepositMultisign, buildDeriveTransferSpotMultisign, collectDeriveTickerRows, deriveActionManagerAddress, deriveActionTypehash, deriveAdvisorNotes, deriveApiBaseUrl, deriveApiBaseUrlForChainId, deriveApiFallbackBaseUrl, deriveAtmTickerWindow, deriveAuthHeaders, deriveDomainSeparator, deriveE18, deriveEmptySubaccountsPayload, deriveExpirySec, deriveExpiryUnixToYmd, deriveFetchCurrenciesRaw, deriveFetchCurrenciesSummary, deriveFetchInstrument, deriveFetchMarketSnapshotSummary, deriveFetchOhlcvSummary, deriveFetchOpenOrdersSummary, deriveFetchOptionChainAgentSummary, deriveFetchOptionChainSummary, deriveFetchOptionInstruments, deriveFetchOrderBookSummary, deriveFetchPendingDepositsSummary, deriveFetchPortfolioSummary, deriveFetchPositionsSummary, deriveFetchRiskUniversesSummary, deriveFetchSubaccountsSummary, deriveFetchTickersSummary, deriveFundRouteForAssetRow, deriveFundableTokensForChain, deriveHypeVaultAddress, deriveKeyForNodeAssetRow, deriveLoginDigest, deriveLoginMessage, deriveLoginTimestamp, deriveMappedTokensForChain, deriveMatchingDomain, deriveNativeWrappedForChain, deriveNetworkFromChainId, deriveOrderQuoteSummary, deriveParseInstrumentName, deriveProtocolModule, deriveRandomNonce, deriveRegisterDepositAddress, deriveRpc, deriveSearchInstruments, deriveSearchInstrumentsSummary, deriveSettlementChainId, deriveSocketRouteForToken, deriveSocketWethRoute, encodeDeriveTradeData, encodeDeriveTransferData, hashDeriveAction, isDeriveAssetRowChainId, isDeriveChainSupported, isDerivePublicMethod, isDeriveRecoverablePublicError, isDeriveSettlementChainId, isDeriveSocketChainId, isEmptyDerivePublicResult, mapDeriveOrderBookLevels, mapDeriveTickerRow, mapDeriveTradingviewCandles, normalizeDeriveExpiryYmd, requireDeriveAuth, resolveDeriveOhlcvWindow, summarizeDeriveOptionChain, synthesizeDeriveRiskUniversesFromCurrencies };