svm venue: deriverse

Solana venue integration deriverse, exported from @eco-incorp/sauce/svm. Generated from the type declarations of @eco-incorp/sauce.

`conservativeFeePpm`

Function · @eco-incorp/sauce/svm Bakes ONE conservative fee-ppm constant from a fetch-time snapshot of the instrument’s fee inputs. ZeroFees (mask bit 0x1) is a protocol invariant that zeros BOTH the AMM fee_rate and the protocol swap_fee_rate (lib.rs’s quote(), both branches check it first) - trusted exactly, no margin. Otherwise: FixedFees (0x2) uses the admin-set static fixed_fee_rate; the default case uses the DYNAMIC day_volatility * spot_fee_rate * FEE_RATE_STEP, which can drift between this snapshot and the eventual cook (it is a live, per-trade-recalculated statistic, not frozen). Either way the raw ppm is DOUBLED plus a flat +20ppm floor: the margin absorbs (a) day_volatility drift and (b) the deployed binary’s protocol-level swap_fee_rate (currently the constant 0 in the drv-models crate, but not independently re-derivable from account state, and a bigger assumed fee only ever LOWERS the predicted output - the safe direction; assuming it stays 0 is the unsafe one). This is the ONLY fee derivation this adapter does off-chain; the ladder never reads day_volatility/fixed_fee_rate live.

export declare function conservativeFeePpm(mask: number, dayVolatility: number, spotFeeRate: number, fixedFeeRate: number): bigint;

`deriverseSwapAccounts`

Function · @eco-incorp/sauce/svm The 14-account order for Deriverse’s Swap (disc 26 - SwapInstruction:: MIN_ACCOUNTS), shared by v1 buildSwap and v2 buildSwapV2: [signer, asset mint, crncy mint, asset vault, crncy vault, instrument, {asks_tree, ask_orders} on buy / {bids_tree, bid_orders} on sell, lines, maps, client infos, asset-side user ATA, crncy-side user ATA, token program]. User ATAs are POSITIONAL BY MINT (asset vs crncy), not by direction - the same trap documented on solfi-v2/quantum.

export declare function deriverseSwapAccounts(c: DeriversePoolConfig, user: SwapUser, make: (ref: string, addr: Address, writable?: boolean) => VenueAccount, refFor?: (role: string) => string): VenueAccount[];

`DERIVERSE_PROGRAM_ID`

Variable · @eco-incorp/sauce/svm

DERIVERSE_PROGRAM_ID: Address

`DERIVERSE_AUTH`

Variable · @eco-incorp/sauce/svm find_program_address([b"ndxnt"], programId) - ONE PDA for the whole program (drv-smart-contract-common’s DRVS_SEED), independent of any pool. Hardcoded (verified against mainnet via an offline PDA derivation, not read from any account) exactly like raydium-amm-v4’s AMM_AUTHORITY.

DERIVERSE_AUTH: Address

`INSTR_ACCOUNT_HEADER_MIN_SIZE`

Variable · @eco-incorp/sauce/svm The front slice of InstrAccountHeader this adapter reads (1064 bytes, drv-smart-contract-common v0.2.68). The LIVE deployed account is larger (2344 bytes observed on both checked instruments) - the extra bytes are unread reserved tail space (candle/history buffers not yet promoted to named fields), exactly the pattern jupiter-deriverse’s own AccountsHolder::from_account relies on (&data[0..size_of::<T>()]). fetchPoolConfig accepts anything >= this size, never an exact match.

INSTR_ACCOUNT_HEADER_MIN_SIZE = 1064

`OFF_MASK`

Variable · @eco-incorp/sauce/svm

OFF_MASK = 28

`OFF_LAST_PX`

Variable · @eco-incorp/sauce/svm

OFF_LAST_PX = 32

`OFF_ASSET_TOKENS`

Variable · @eco-incorp/sauce/svm

OFF_ASSET_TOKENS = 144

`OFF_CRNCY_TOKENS`

Variable · @eco-incorp/sauce/svm

OFF_CRNCY_TOKENS = 152

`OFF_DEC_FACTOR`

Variable · @eco-incorp/sauce/svm

OFF_DEC_FACTOR = 800

`MASK_SUSPENDED`

Variable · @eco-incorp/sauce/svm

MASK_SUSPENDED = 32

`DeriversePoolConfig`

Interface · @eco-incorp/sauce/svm

export interface DeriversePoolConfig extends PoolConfig {
    venue: typeof SLUG;
    side: "buy" | "sell";
    instrId: number;
    assetTokenId: number;
    crncyTokenId: number;
    assetMint: Address;
    crncyMint: Address;
    assetVault: Address;
    crncyVault: Address;
    asksTree: Address;
    askOrders: Address;
    bidsTree: Address;
    bidOrders: Address;
    lines: Address;
    mapsAddress: Address;
    clientInfos: Address;
    tokenProgram: Address;
    feePpm: bigint;
}

`deriverse`

Variable · @eco-incorp/sauce/svm

deriverse: {
    slug: string;
    kind: "constant-product";
    programId: Address;
    fetchPoolConfig(owned: OwnedAccountLoader, pool: Address): Promise<DeriversePoolConfig>;
    quoteAccounts(cfg: PoolConfig): VenueAccount[];
    buildSwap(cfg: PoolConfig, user: SwapUser, amountIn: bigint): VenueSwap;
}

Start here

Integration guides

Language reference

SauceScript libraries

Runtime and security

Troubleshooting and production

Chains and protocols

@eco-incorp/sauce

@eco-incorp/sauce-compiler

svm venue: deriverse

`conservativeFeePpm`

`deriverseSwapAccounts`

`DERIVERSE_PROGRAM_ID`

`DERIVERSE_AUTH`

`INSTR_ACCOUNT_HEADER_MIN_SIZE`

`OFF_MASK`

`OFF_LAST_PX`

`OFF_ASSET_TOKENS`

`OFF_CRNCY_TOKENS`

`OFF_DEC_FACTOR`

`MASK_SUSPENDED`

`DeriversePoolConfig`

`deriverse`

​conservativeFeePpm

​deriverseSwapAccounts

​DERIVERSE_PROGRAM_ID

​DERIVERSE_AUTH

​INSTR_ACCOUNT_HEADER_MIN_SIZE

​OFF_MASK

​OFF_LAST_PX

​OFF_ASSET_TOKENS

​OFF_CRNCY_TOKENS

​OFF_DEC_FACTOR

​MASK_SUSPENDED

​DeriversePoolConfig

​deriverse

`conservativeFeePpm`

`deriverseSwapAccounts`

`DERIVERSE_PROGRAM_ID`

`DERIVERSE_AUTH`

`INSTR_ACCOUNT_HEADER_MIN_SIZE`

`OFF_MASK`

`OFF_LAST_PX`

`OFF_ASSET_TOKENS`

`OFF_CRNCY_TOKENS`

`OFF_DEC_FACTOR`

`MASK_SUSPENDED`

`DeriversePoolConfig`

`deriverse`