@sodax/types 2.0.0-rc.2 → 2.0.0-rc.20

package/dist/index.js

@@ -6,9 +6,11 @@ export * from './backend/index.js';
 export * from './bitcoin/index.js';
 export * from './dex/index.js';
 export * from './evm/index.js';
+export * from './hooks/index.js';
 export * from './icon/index.js';
 export * from './injective/index.js';
 export * from './moneyMarket/index.js';
+export * from './leverageYield/index.js';
 export * from './near/index.js';
 export * from './solana/index.js';
 export * from './stacks/index.js';
@@ -17,5 +19,4 @@ export * from './sui/index.js';
 export * from './swap/index.js';
 export * from './utils/index.js';
 export * from './wallet/index.js';
-export const CONFIG_VERSION = 200; // this value should be incremented (inside release/sdk branch) each time @sodax/types package is updated
-//# sourceMappingURL=index.js.map
+export const CONFIG_VERSION = 218; // this value should be incremented (inside release/sdk branch) each time @sodax/types package is updated

package/dist/injective/index.d.ts

@@ -1,2 +1 @@
 export * from './injective.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/injective/index.js

@@ -1,2 +1 @@
 export * from './injective.js';
-//# sourceMappingURL=index.js.map

package/dist/injective/injective.d.ts

@@ -99,5 +99,8 @@ export interface IInjectiveWalletProvider extends ICoreWallet {
     readonly chainType: 'INJECTIVE';
     getWalletAddress: () => Promise<InjectiveEoaAddress>;
     execute: (senderAddress: InjectiveEoaAddress, contractAddress: string, msg: JsonObject, funds?: InjectiveCoin[]) => Promise<InjectiveExecuteResponse>;
+    /** Broadcast an already-signed, proto-encoded Cosmos `TxRaw`. Returns the tx hash. */
+    sendTransaction?: (signedTxRaw: Uint8Array) => Promise<string>;
+    /** Sign and broadcast an unsigned `InjectiveRawTransaction` (e.g. from the Swaps API). Returns the tx hash. */
+    signAndSendTransaction?: (tx: InjectiveRawTransaction) => Promise<string>;
 }
-//# sourceMappingURL=injective.d.ts.map

package/dist/injective/injective.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=injective.js.map

package/dist/leverageYield/index.d.ts

@@ -0,0 +1 @@
+export * from './leverageYield.js';

package/dist/leverageYield/index.js

@@ -0,0 +1 @@
+export * from './leverageYield.js';

package/dist/leverageYield/leverageYield.d.ts

@@ -0,0 +1,152 @@
+import type { Address } from '../shared/shared.js';
+import type { PartnerFee, Prettify } from '../common/common.js';
+/**
+ * A single deployed LeverageYieldVault.
+ *
+ * The vault is an ERC-4626 wrapper on the Sonic hub. It accepts deposits of `asset` (a
+ * Sodax vault token like sodaWEETH), borrows `borrowToken` from the Sodax-forked AAVE
+ * pool, swaps the borrowed amount back into the asset, and re-supplies — yielding a
+ * leveraged long on the asset / borrowToken peg.
+ *
+ * The fields here are static descriptors of the deployed vault. Cross-chain deposits and
+ * withdrawals route by the user's spoke-side token (e.g. weETH on Arbitrum); the hub-side
+ * AssetToken and Sodax vault token are resolved at call time by `ConfigService`. This
+ * registry exists for vault discovery and UI display, not for routing.
+ */
+export type LeverageYieldVault = {
+    /**
+     * Stable lookup key — by convention the leverage-vault share-token symbol
+     * (e.g. `'lsodaWEETH'`, `'lsodaWSTETH'`). Used by `LeverageYieldService.getVault(name)`.
+     */
+    name: string;
+    /** Deployed `LeverageYieldVault` proxy address on the Sonic hub. */
+    vault: Address;
+    /**
+     * The vault's underlying asset on the hub — the ERC-20 a depositor effectively holds via
+     * vault shares. Always a Sodax vault-token wrapper (e.g. sodaWEETH), since user deposits
+     * are bridged in as the underlying hub asset and wrapped before the leverage vault deposit.
+     */
+    asset: Address;
+    /**
+     * The token the vault borrows from the Sodax-forked AAVE pool against `asset` collateral.
+     * Always a Sodax vault-token wrapper (e.g. sodaETH), matching the asset side. Drives the
+     * leverage direction: the position is a long on the `asset` / `borrowToken` peg.
+     */
+    borrowToken: Address;
+    /**
+     * LSD staking-APR source for the underlying asset. When present, callers can use
+     * `LeverageYieldService.getEffectiveApr(vault)` to combine AAVE rates with the LSD's
+     * native staking yield — the primary yield source for LSD-backed strategies. Omit for
+     * non-LSD vaults; the SDK then treats the LSD yield as 0%.
+     */
+    lsdSource?: LeverageYieldLsdSource;
+};
+/**
+ * Off-chain LSD staking-APR source for a leverage-yield vault. The vault's underlying asset
+ * is an LSD (weETH, wstETH, …) that appreciates against its base asset (ETH) at the LSD's
+ * native staking rate — yield that does **not** appear in AAVE's `currentLiquidityRate` and
+ * that the SDK must therefore fetch off-chain to report an honest effective APR.
+ *
+ * The SDK fetches all LSD APRs from DefiLlama's per-pool endpoint
+ * (`https://yields.llama.fi/chart/<poolId>`) — one CORS-friendly source that already
+ * aggregates rates across LSD issuers, so no provider-specific dispatch is needed in the
+ * service. Pure data — no functions — so the registry stays serialisable.
+ */
+export type LeverageYieldLsdSource = {
+    /**
+     * DefiLlama pool ID (UUID) for the LSD's staking pool. Find via the bulk `/pools`
+     * endpoint, e.g. `data.filter(p => p.symbol === 'STETH' && p.project === 'lido')`.
+     * Examples:
+     *  - Lido stETH:   `747c1d2a-c668-4682-b9f9-296708a3dd90`
+     *  - EtherFi weETH: `46bd2bdf-6d92-4066-b482-e885ee172264`
+     */
+    poolId: string;
+    /**
+     * Hardcoded APR (percentage, e.g. `3.2` for 3.2%) used when the DefiLlama fetch errors.
+     * Should reflect the trailing 30-day yield from the issuer's dashboard; update via PR if
+     * it drifts >50 bp from reality.
+     */
+    fallbackAprPct: number;
+    /** Human label for UI display, e.g. `'Lido (stETH)'` or `'EtherFi (weETH)'`. */
+    label: string;
+};
+/**
+ * SDK-wide registry of known leverage vaults. Add an entry here when a vault is promoted
+ * to a default; callers can also override per-instance via the `Sodax({ leverageYield:
+ * { vaults: [...] } })` config slot.
+ *
+ * Addresses are sourced from the canonical token registries — the proxy/share-token address
+ * from {@link LsodaTokens} and the hub-side `asset` / `borrowToken` from {@link SodaTokens} —
+ * so a deployment-address change lives in exactly one place.
+ */
+export declare const leverageYieldVaults: readonly [{
+    readonly name: "lsodaWEETH";
+    readonly vault: "0xD09de2f5070699A909c0FD32fb5A909d3886701D";
+    readonly asset: "0xCb6B152D3a943f25157381aFcA7fEFCD2ef5a357";
+    readonly borrowToken: "0x4effB5813271699683C25c734F4daBc45B363709";
+    readonly lsdSource: {
+        readonly poolId: "46bd2bdf-6d92-4066-b482-e885ee172264";
+        readonly fallbackAprPct: 3;
+        readonly label: "EtherFi (weETH)";
+    };
+}, {
+    readonly name: "lsodaWSTETH";
+    readonly vault: "0x136E5D1CEC5db1829E24941Eddd9C8640E02Ce7a";
+    readonly asset: "0x58b0538D7EEaeE69EF32f9F1dE5cbF32A10a977B";
+    readonly borrowToken: "0x4effB5813271699683C25c734F4daBc45B363709";
+    readonly lsdSource: {
+        readonly poolId: "747c1d2a-c668-4682-b9f9-296708a3dd90";
+        readonly fallbackAprPct: 2.4;
+        readonly label: "Lido (stETH)";
+    };
+}, {
+    readonly name: "lsodaJITOSOL";
+    readonly vault: "0xD7Ae4853E0f93682F5DaA14734F5D18cBa09Bd78";
+    readonly asset: "0xe1bad4400d947Bc4fa66f9c0A143D800002083a0";
+    readonly borrowToken: "0xdEa692287E2cE8Cb08FA52917Be0F16b1DACDC87";
+    readonly lsdSource: {
+        readonly poolId: "0e7d0722-9054-4907-8593-567b353c0900";
+        readonly fallbackAprPct: 5.5;
+        readonly label: "Jito (JitoSOL)";
+    };
+}];
+export type LeverageYieldOptions = {
+    partnerFee?: PartnerFee;
+};
+export type LeverageYieldConfig = Prettify<LeverageYieldDefaultConfig & LeverageYieldOptions>;
+export type LeverageYieldDefaultConfig = {
+    vaults: readonly LeverageYieldVault[];
+};
+export declare const leverageYieldConfig: {
+    readonly vaults: readonly [{
+        readonly name: "lsodaWEETH";
+        readonly vault: "0xD09de2f5070699A909c0FD32fb5A909d3886701D";
+        readonly asset: "0xCb6B152D3a943f25157381aFcA7fEFCD2ef5a357";
+        readonly borrowToken: "0x4effB5813271699683C25c734F4daBc45B363709";
+        readonly lsdSource: {
+            readonly poolId: "46bd2bdf-6d92-4066-b482-e885ee172264";
+            readonly fallbackAprPct: 3;
+            readonly label: "EtherFi (weETH)";
+        };
+    }, {
+        readonly name: "lsodaWSTETH";
+        readonly vault: "0x136E5D1CEC5db1829E24941Eddd9C8640E02Ce7a";
+        readonly asset: "0x58b0538D7EEaeE69EF32f9F1dE5cbF32A10a977B";
+        readonly borrowToken: "0x4effB5813271699683C25c734F4daBc45B363709";
+        readonly lsdSource: {
+            readonly poolId: "747c1d2a-c668-4682-b9f9-296708a3dd90";
+            readonly fallbackAprPct: 2.4;
+            readonly label: "Lido (stETH)";
+        };
+    }, {
+        readonly name: "lsodaJITOSOL";
+        readonly vault: "0xD7Ae4853E0f93682F5DaA14734F5D18cBa09Bd78";
+        readonly asset: "0xe1bad4400d947Bc4fa66f9c0A143D800002083a0";
+        readonly borrowToken: "0xdEa692287E2cE8Cb08FA52917Be0F16b1DACDC87";
+        readonly lsdSource: {
+            readonly poolId: "0e7d0722-9054-4907-8593-567b353c0900";
+            readonly fallbackAprPct: 5.5;
+            readonly label: "Jito (JitoSOL)";
+        };
+    }];
+};

package/dist/leverageYield/leverageYield.js

@@ -0,0 +1,51 @@
+import { LsodaTokens, SodaTokens } from '../chains/tokens.js';
+/**
+ * SDK-wide registry of known leverage vaults. Add an entry here when a vault is promoted
+ * to a default; callers can also override per-instance via the `Sodax({ leverageYield:
+ * { vaults: [...] } })` config slot.
+ *
+ * Addresses are sourced from the canonical token registries — the proxy/share-token address
+ * from {@link LsodaTokens} and the hub-side `asset` / `borrowToken` from {@link SodaTokens} —
+ * so a deployment-address change lives in exactly one place.
+ */
+export const leverageYieldVaults = [
+    {
+        name: LsodaTokens.lsodaWEETH.symbol,
+        vault: LsodaTokens.lsodaWEETH.vault,
+        asset: SodaTokens.sodaWEETH.address, // sodaWEETH on Sonic
+        borrowToken: SodaTokens.sodaETH.address, // sodaETH on Sonic
+        lsdSource: {
+            // DefiLlama pool for EtherFi's weETH on Ethereum (project: 'ether.fi-stake').
+            poolId: '46bd2bdf-6d92-4066-b482-e885ee172264',
+            fallbackAprPct: 3.0,
+            label: 'EtherFi (weETH)',
+        },
+    },
+    {
+        name: LsodaTokens.lsodaWSTETH.symbol,
+        vault: LsodaTokens.lsodaWSTETH.vault,
+        asset: SodaTokens.sodaWSTETH.address, // sodaWSTETH on Sonic
+        borrowToken: SodaTokens.sodaETH.address, // sodaETH on Sonic
+        lsdSource: {
+            // DefiLlama pool for Lido's stETH on Ethereum (wstETH inherits this rate via redeem).
+            poolId: '747c1d2a-c668-4682-b9f9-296708a3dd90',
+            fallbackAprPct: 2.4,
+            label: 'Lido (stETH)',
+        },
+    },
+    {
+        name: LsodaTokens.lsodaJITOSOL.symbol,
+        vault: LsodaTokens.lsodaJITOSOL.vault,
+        asset: SodaTokens.sodaJITOSOL.address, // sodaJITOSOL on Sonic
+        borrowToken: SodaTokens.sodaSOL.address, // sodaSOL on Sonic
+        lsdSource: {
+            // DefiLlama pool for Jito's JitoSOL native staking on Solana (project: 'jito-liquid-staking').
+            poolId: '0e7d0722-9054-4907-8593-567b353c0900',
+            fallbackAprPct: 5.5,
+            label: 'Jito (JitoSOL)',
+        },
+    },
+];
+export const leverageYieldConfig = {
+    vaults: leverageYieldVaults,
+};

package/dist/moneyMarket/index.d.ts

@@ -1,2 +1 @@
 export * from './moneyMarket.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/moneyMarket/index.js

@@ -1,2 +1 @@
 export * from './moneyMarket.js';
-//# sourceMappingURL=index.js.map