@0block.io/sdk 0.1.0

package/dist/idl/router.d.ts

@@ -0,0 +1,652 @@
+export declare const ROUTER_IDL: {
+    readonly address: "zeroRxfemoQCz6JT7RyShjuuRCN7VZof1WSekfXhmEn";
+    readonly metadata: {
+        readonly name: "zeroblock_solana_dex_router";
+        readonly version: "0.1.0";
+        readonly spec: "0.1.0";
+        readonly description: "0block Solana DEX Router";
+    };
+    readonly instructions: readonly [{
+        readonly name: "swap";
+        readonly discriminator: readonly [248, 198, 158, 145, 225, 117, 135, 200];
+        readonly accounts: readonly [{
+            readonly name: "payer";
+            readonly docs: readonly ["User paying tx fees and commissions."];
+            readonly writable: true;
+            readonly signer: true;
+        }, {
+            readonly name: "source_token_account";
+            readonly docs: readonly ["SOURCE token account (authority = payer)"];
+            readonly writable: true;
+        }, {
+            readonly name: "destination_token_account";
+            readonly docs: readonly ["DESTINATION token account (receives the swap output)"];
+            readonly writable: true;
+        }, {
+            readonly name: "source_mint";
+        }, {
+            readonly name: "destination_mint";
+        }, {
+            readonly name: "global_cfg";
+            readonly docs: readonly ["Global config (zero_copy)"];
+            readonly pda: {
+                readonly seeds: readonly [{
+                    readonly kind: "const";
+                    readonly value: readonly [99, 111, 110, 102, 105, 103];
+                }];
+            };
+        }, {
+            readonly name: "tenant_cfg";
+            readonly docs: readonly ["Tenant config (strict wrapper model)"];
+            readonly pda: {
+                readonly seeds: readonly [{
+                    readonly kind: "const";
+                    readonly value: readonly [116, 101, 110, 97, 110, 116];
+                }, {
+                    readonly kind: "account";
+                    readonly path: "tenant_cfg.tenant_wrapper_program";
+                    readonly account: "TenantConfig";
+                }];
+            };
+        }, {
+            readonly name: "tenant_authority";
+            readonly docs: readonly ["Tenant authority (EOA or PDA) permitted by TenantConfig (wrapper signs)"];
+            readonly signer: true;
+        }, {
+            readonly name: "zeroblock_sol_vault";
+            readonly docs: readonly ["0BLOCK fee authority (owns 0BLOCK fee token accounts)"];
+            readonly writable: true;
+        }, {
+            readonly name: "tenant_sol_vault";
+            readonly docs: readonly ["Tenant fee authority (owns tenant fee token accounts)"];
+            readonly writable: true;
+        }, {
+            readonly name: "zeroblock_fee_token_account";
+            readonly writable: true;
+        }, {
+            readonly name: "tenant_fee_token_account";
+            readonly writable: true;
+        }, {
+            readonly name: "source_token_program";
+            readonly optional: true;
+        }, {
+            readonly name: "destination_token_program";
+            readonly optional: true;
+        }, {
+            readonly name: "associated_token_program";
+            readonly optional: true;
+            readonly address: "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL";
+        }, {
+            readonly name: "system_program";
+            readonly optional: true;
+            readonly address: "11111111111111111111111111111111";
+        }, {
+            readonly name: "ix_sysvar";
+            readonly docs: readonly ["Instructions sysvar for wrapper-only enforcement"];
+            readonly address: "Sysvar1nstructions1111111111111111111111111";
+        }];
+        readonly args: readonly [{
+            readonly name: "args";
+            readonly type: {
+                readonly defined: {
+                    readonly name: "SwapArgs";
+                };
+            };
+        }, {
+            readonly name: "order_id";
+            readonly type: "u128";
+        }, {
+            readonly name: "tenant_fee_bps";
+            readonly type: {
+                readonly option: "u16";
+            };
+        }];
+    }];
+    readonly accounts: readonly [];
+    readonly events: readonly [{
+        readonly name: "SwapResultEvent";
+        readonly discriminator: readonly [65, 188, 138, 167, 38, 187, 55, 46];
+    }];
+    readonly errors: readonly [];
+    readonly types: readonly [{
+        readonly name: "CommissionBreakdown";
+        readonly type: {
+            readonly kind: "struct";
+            readonly fields: readonly [{
+                readonly name: "fee_mint";
+                readonly type: "pubkey";
+            }, {
+                readonly name: "fee_source";
+                readonly type: {
+                    readonly defined: {
+                        readonly name: "FeeSource";
+                    };
+                };
+            }, {
+                readonly name: "fee_base_amount";
+                readonly type: "u64";
+            }, {
+                readonly name: "total_fee_amount";
+                readonly type: "u64";
+            }, {
+                readonly name: "items";
+                readonly type: {
+                    readonly vec: {
+                        readonly defined: {
+                            readonly name: "CommissionItem";
+                        };
+                    };
+                };
+            }];
+        };
+    }, {
+        readonly name: "CommissionItem";
+        readonly type: {
+            readonly kind: "struct";
+            readonly fields: readonly [{
+                readonly name: "kind";
+                readonly type: {
+                    readonly defined: {
+                        readonly name: "CommissionType";
+                    };
+                };
+            }, {
+                readonly name: "bps";
+                readonly type: "u16";
+            }, {
+                readonly name: "amount";
+                readonly type: "u64";
+            }, {
+                readonly name: "tenant_program";
+                readonly docs: readonly ["Tenant wrapper program id for TENANT commissions; default pubkey for PLATFORM."];
+                readonly type: "pubkey";
+            }];
+        };
+    }, {
+        readonly name: "CommissionType";
+        readonly type: {
+            readonly kind: "enum";
+            readonly variants: readonly [{
+                readonly name: "Platform";
+            }, {
+                readonly name: "Tenant";
+            }];
+        };
+    }, {
+        readonly name: "Dex";
+        readonly docs: readonly ["Which DEX / adapter to call for each hop."];
+        readonly type: {
+            readonly kind: "enum";
+            readonly variants: readonly [{
+                readonly name: "SplTokenSwap";
+            }, {
+                readonly name: "StableSwap";
+            }, {
+                readonly name: "Whirlpool";
+            }, {
+                readonly name: "MeteoraDynamicpool";
+            }, {
+                readonly name: "RaydiumSwap";
+            }, {
+                readonly name: "RaydiumStableSwap";
+            }, {
+                readonly name: "RaydiumClmmSwap";
+            }, {
+                readonly name: "AldrinExchangeV1";
+            }, {
+                readonly name: "AldrinExchangeV2";
+            }, {
+                readonly name: "LifinityV1";
+            }, {
+                readonly name: "LifinityV2";
+            }, {
+                readonly name: "RaydiumClmmSwapV2";
+            }, {
+                readonly name: "FluxBeam";
+            }, {
+                readonly name: "MeteoraDlmm";
+            }, {
+                readonly name: "RaydiumCpmmSwap";
+            }, {
+                readonly name: "OpenBookV2";
+            }, {
+                readonly name: "WhirlpoolV2";
+            }, {
+                readonly name: "Phoenix";
+            }, {
+                readonly name: "ObricV2";
+            }, {
+                readonly name: "SanctumAddLiq";
+            }, {
+                readonly name: "SanctumRemoveLiq";
+            }, {
+                readonly name: "SanctumNonWsolSwap";
+            }, {
+                readonly name: "SanctumWsolSwap";
+            }, {
+                readonly name: "PumpfunBuy";
+            }, {
+                readonly name: "PumpfunSell";
+            }, {
+                readonly name: "StabbleSwap";
+            }, {
+                readonly name: "SanctumRouter";
+            }, {
+                readonly name: "MeteoraVaultDeposit";
+            }, {
+                readonly name: "MeteoraVaultWithdraw";
+            }, {
+                readonly name: "Saros";
+            }, {
+                readonly name: "MeteoraLst";
+            }, {
+                readonly name: "Solfi";
+            }, {
+                readonly name: "QualiaSwap";
+            }, {
+                readonly name: "Zerofi";
+            }, {
+                readonly name: "PumpfunammBuy";
+            }, {
+                readonly name: "PumpfunammSell";
+            }, {
+                readonly name: "Virtuals";
+            }, {
+                readonly name: "VertigoBuy";
+            }, {
+                readonly name: "VertigoSell";
+            }, {
+                readonly name: "PerpetualsAddLiq";
+            }, {
+                readonly name: "PerpetualsRemoveLiq";
+            }, {
+                readonly name: "PerpetualsSwap";
+            }, {
+                readonly name: "RaydiumLaunchpad";
+            }, {
+                readonly name: "LetsBonkFun";
+            }, {
+                readonly name: "Woofi";
+            }, {
+                readonly name: "MeteoraDbc";
+            }, {
+                readonly name: "MeteoraDlmmSwap2";
+            }, {
+                readonly name: "MeteoraDAMMV2";
+            }, {
+                readonly name: "Gavel";
+            }, {
+                readonly name: "BoopfunBuy";
+            }, {
+                readonly name: "BoopfunSell";
+            }, {
+                readonly name: "MeteoraDbc2";
+            }, {
+                readonly name: "GooseFX";
+            }, {
+                readonly name: "Dooar";
+            }, {
+                readonly name: "Numeraire";
+            }, {
+                readonly name: "SaberDecimalWrapperDeposit";
+            }, {
+                readonly name: "SaberDecimalWrapperWithdraw";
+            }, {
+                readonly name: "SarosDlmm";
+            }, {
+                readonly name: "OneDexSwap";
+            }, {
+                readonly name: "Manifest";
+            }, {
+                readonly name: "ByrealClmm";
+            }, {
+                readonly name: "PancakeSwapV3Swap";
+            }, {
+                readonly name: "PancakeSwapV3SwapV2";
+            }, {
+                readonly name: "Tessera";
+            }, {
+                readonly name: "SolRfq";
+            }];
+        };
+    }, {
+        readonly name: "FeeSource";
+        readonly type: {
+            readonly kind: "enum";
+            readonly variants: readonly [{
+                readonly name: "Input";
+            }, {
+                readonly name: "Output";
+            }];
+        };
+    }, {
+        readonly name: "GlobalConfig";
+        readonly docs: readonly ["----------------------------------------------------------------------------", "GlobalConfig (zero_copy, fixed-size, upgrade-safe)", "----------------------------------------------------------------------------"];
+        readonly serialization: "bytemuckunsafe";
+        readonly repr: {
+            readonly kind: "c";
+        };
+        readonly type: {
+            readonly kind: "struct";
+            readonly fields: readonly [{
+                readonly name: "bump";
+                readonly docs: readonly ["PDA bump"];
+                readonly type: "u8";
+            }, {
+                readonly name: "admin";
+                readonly docs: readonly ["Program admin (controls global/tenant settings)"];
+                readonly type: "pubkey";
+            }, {
+                readonly name: "zeroblock_fee_bps";
+                readonly docs: readonly ["0BLOCK platform fee default (bps out of 10_000)"];
+                readonly type: "u16";
+            }, {
+                readonly name: "zeroblock_fee_vault";
+                readonly docs: readonly ["Fee authority that owns 0BLOCK fee token accounts"];
+                readonly type: "pubkey";
+            }, {
+                readonly name: "padding";
+                readonly docs: readonly ["Reserved to keep struct size stable for future upgrades"];
+                readonly type: {
+                    readonly array: readonly ["u8", 160];
+                };
+            }];
+        };
+    }, {
+        readonly name: "InitGlobalConfigEvent";
+        readonly docs: readonly ["----------------------------------------------------------------------------", "Global config events", "----------------------------------------------------------------------------"];
+        readonly type: {
+            readonly kind: "struct";
+            readonly fields: readonly [{
+                readonly name: "admin";
+                readonly type: "pubkey";
+            }, {
+                readonly name: "zeroblock_fee_bps";
+                readonly type: "u16";
+            }, {
+                readonly name: "zeroblock_fee_vault";
+                readonly docs: readonly ["Fee owner that receives 0BLOCK's platform fees (token accounts owned by this key)"];
+                readonly type: "pubkey";
+            }];
+        };
+    }, {
+        readonly name: "Route";
+        readonly type: {
+            readonly kind: "struct";
+            readonly fields: readonly [{
+                readonly name: "dexes";
+                readonly type: {
+                    readonly vec: {
+                        readonly defined: {
+                            readonly name: "Dex";
+                        };
+                    };
+                };
+            }, {
+                readonly name: "weights";
+                readonly type: "bytes";
+            }];
+        };
+    }, {
+        readonly name: "SetAdminEvent";
+        readonly type: {
+            readonly kind: "struct";
+            readonly fields: readonly [{
+                readonly name: "admin";
+                readonly type: "pubkey";
+            }];
+        };
+    }, {
+        readonly name: "SetZeroblockFeeBpsEvent";
+        readonly type: {
+            readonly kind: "struct";
+            readonly fields: readonly [{
+                readonly name: "zeroblock_fee_bps";
+                readonly type: "u16";
+            }];
+        };
+    }, {
+        readonly name: "SetZeroblockFeeVaultEvent";
+        readonly type: {
+            readonly kind: "struct";
+            readonly fields: readonly [{
+                readonly name: "zeroblock_fee_vault";
+                readonly type: "pubkey";
+            }];
+        };
+    }, {
+        readonly name: "Slippage";
+        readonly type: {
+            readonly kind: "enum";
+            readonly variants: readonly [{
+                readonly name: "Bps";
+                readonly fields: readonly [{
+                    readonly name: "bps";
+                    readonly type: "u16";
+                }, {
+                    readonly name: "expect_amount_out";
+                    readonly type: "u64";
+                }];
+            }, {
+                readonly name: "MinOut";
+                readonly fields: readonly ["u64"];
+            }];
+        };
+    }, {
+        readonly name: "SwapArgs";
+        readonly type: {
+            readonly kind: "struct";
+            readonly fields: readonly [{
+                readonly name: "amount_in";
+                readonly type: "u64";
+            }, {
+                readonly name: "min_return";
+                readonly type: "u64";
+            }, {
+                readonly name: "amounts";
+                readonly type: {
+                    readonly vec: "u64";
+                };
+            }, {
+                readonly name: "routes";
+                readonly type: {
+                    readonly vec: {
+                        readonly vec: {
+                            readonly defined: {
+                                readonly name: "Route";
+                            };
+                        };
+                    };
+                };
+            }, {
+                readonly name: "options";
+                readonly type: {
+                    readonly option: {
+                        readonly defined: {
+                            readonly name: "SwapOptions";
+                        };
+                    };
+                };
+            }];
+        };
+    }, {
+        readonly name: "SwapExecution";
+        readonly type: {
+            readonly kind: "struct";
+            readonly fields: readonly [{
+                readonly name: "amount_in";
+                readonly type: "u64";
+            }, {
+                readonly name: "amount_out";
+                readonly type: "u64";
+            }, {
+                readonly name: "min_return";
+                readonly type: "u64";
+            }, {
+                readonly name: "expect_amount_out";
+                readonly type: "u64";
+            }, {
+                readonly name: "legs";
+                readonly type: {
+                    readonly vec: {
+                        readonly defined: {
+                            readonly name: "SwapLeg";
+                        };
+                    };
+                };
+            }];
+        };
+    }, {
+        readonly name: "SwapFailure";
+        readonly type: {
+            readonly kind: "struct";
+            readonly fields: readonly [{
+                readonly name: "code";
+                readonly type: "u64";
+            }, {
+                readonly name: "message";
+                readonly type: "string";
+            }];
+        };
+    }, {
+        readonly name: "SwapLeg";
+        readonly type: {
+            readonly kind: "struct";
+            readonly fields: readonly [{
+                readonly name: "dex";
+                readonly type: {
+                    readonly defined: {
+                        readonly name: "Dex";
+                    };
+                };
+            }, {
+                readonly name: "amount_in";
+                readonly type: "u64";
+            }, {
+                readonly name: "amount_out";
+                readonly type: "u64";
+            }, {
+                readonly name: "route_index";
+                readonly type: "u16";
+            }, {
+                readonly name: "hop_index";
+                readonly type: "u16";
+            }, {
+                readonly name: "fork_index";
+                readonly type: "u16";
+            }];
+        };
+    }, {
+        readonly name: "SwapOptions";
+        readonly type: {
+            readonly kind: "struct";
+            readonly fields: readonly [{
+                readonly name: "slippage";
+                readonly type: {
+                    readonly option: {
+                        readonly defined: {
+                            readonly name: "Slippage";
+                        };
+                    };
+                };
+            }];
+        };
+    }, {
+        readonly name: "SwapResultData";
+        readonly docs: readonly ["----------------------------------------------------------------------------", "Swap result event (single event per attempt)", "----------------------------------------------------------------------------"];
+        readonly type: {
+            readonly kind: "enum";
+            readonly variants: readonly [{
+                readonly name: "Success";
+                readonly fields: readonly [{
+                    readonly defined: {
+                        readonly name: "SwapSuccess";
+                    };
+                }];
+            }, {
+                readonly name: "Failure";
+                readonly fields: readonly [{
+                    readonly defined: {
+                        readonly name: "SwapFailure";
+                    };
+                }];
+            }];
+        };
+    }, {
+        readonly name: "SwapResultEvent";
+        readonly type: {
+            readonly kind: "struct";
+            readonly fields: readonly [{
+                readonly name: "order_id";
+                readonly type: "u128";
+            }, {
+                readonly name: "data";
+                readonly type: {
+                    readonly defined: {
+                        readonly name: "SwapResultData";
+                    };
+                };
+            }];
+        };
+    }, {
+        readonly name: "SwapSuccess";
+        readonly type: {
+            readonly kind: "struct";
+            readonly fields: readonly [{
+                readonly name: "swap";
+                readonly type: {
+                    readonly defined: {
+                        readonly name: "SwapExecution";
+                    };
+                };
+            }, {
+                readonly name: "commissions";
+                readonly type: {
+                    readonly defined: {
+                        readonly name: "CommissionBreakdown";
+                    };
+                };
+            }];
+        };
+    }, {
+        readonly name: "TenantConfig";
+        readonly docs: readonly ["----------------------------------------------------------------------------", "TenantConfig (+ strict wrapper enforcement)", "----------------------------------------------------------------------------"];
+        readonly type: {
+            readonly kind: "struct";
+            readonly fields: readonly [{
+                readonly name: "bump";
+                readonly type: "u8";
+            }, {
+                readonly name: "tenant_authority";
+                readonly docs: readonly ["Signer (EOA or PDA) authorized to act for this tenant"];
+                readonly type: "pubkey";
+            }, {
+                readonly name: "tenant_wrapper_program";
+                readonly docs: readonly ["Wrapper program id used to validate tenant-mode calls."];
+                readonly type: "pubkey";
+            }, {
+                readonly name: "zeroblock_fee_bps";
+                readonly docs: readonly ["0BLOCK fee (bps out of 10_000) for this tenant. Use 0 to fall back to global default."];
+                readonly type: "u16";
+            }, {
+                readonly name: "tenant_fee_vault";
+                readonly docs: readonly ["Fee authority that owns tenant fee token accounts"];
+                readonly type: "pubkey";
+            }, {
+                readonly name: "whitelisted";
+                readonly docs: readonly ["Whether this tenant is active/whitelisted"];
+                readonly type: "bool";
+            }, {
+                readonly name: "max_total_fee_bps";
+                readonly docs: readonly ["Optional per-tenant cap: (tenant_fee_bps + zeroblock_fee_bps) must be <= this if > 0.", "tenant_fee_bps is supplied per swap."];
+                readonly type: "u16";
+            }, {
+                readonly name: "_reserved";
+                readonly docs: readonly ["Reserved for upgrades (fixed size)"];
+                readonly type: {
+                    readonly array: readonly ["u8", 64];
+                };
+            }];
+        };
+    }];
+};