@huma-finance/permissionless-sdk 1.0.3 → 1.0.4-beta.20250910221307.cf6362e

package/README.md

@@ -0,0 +1,100 @@
+# Huma Permissionless SDK
+
+This is an [NPM Package](https://www.npmjs.com/package/@huma-finance/permissionless-sdk) that helps build deposit and withdrawal instructions for the various modes + lockups on Huma 2.0 (Permissionless), and check token prices.
+
+## Current supported features
+
+- Deposit into classic or maxi mode (PST and mPST respectively)
+- Withdraw from classic or maxi mode (redeem PST and mPST tokens)
+- Check the current price of PST and mPST tokens
+- Optionally specify a lockup on these tokens, in most cases you'll want to use the default NO_COMMIT option.
+
+## Depositing
+
+An example Node script integration in /examples/deposit.ts is provided in this repo. For those integrating with react, an example repo using vite and @solana/web3.js is available at https://github.com/00labs/permissionless-sdk-example.
+
+1. Create a `PermissionlessClient`
+
+```
+import {
+  PermissionlessClient,
+  SolanaChainEnum,
+} from "@huma-finance/permissionless-sdk";
+
+new PermissionlessClient(connection, SolanaChainEnum.MAINNET);
+```
+
+2. Build a deposit instruction for either PST (DepositMode.CLASSIC) or mPST (DepositMode.MAXI) (note that token amounts should be denoted in smallest units). At least 1 USDC must be deposited.
+
+```
+import {
+  DepositMode
+} from "@huma-finance/permissionless-sdk";
+
+const tx = await client.buildDepositTx(
+    publicKey,
+    new BN(1000000), /* Deposit 1 USDC */
+    DepositMode.CLASSIC /* Will receive PST */
+);
+```
+
+3. The deposit transaction is intended to only handle the instructions for depositing and creating relevant Huma accounts. It should be up to the implementation to optimize the transaction with the correct blockhashes, compute unit limits, priority fees, etc.
+
+## Redeeming
+
+An example Node script integration in /examples/addRedemptionRequest.ts is provided in this repo.
+
+1. Create a `PermissionlessClient` (same as depositing)
+
+```
+import {
+  PermissionlessClient,
+  SolanaChainEnum,
+} from "@huma-finance/permissionless-sdk";
+
+new PermissionlessClient(connection, SolanaChainEnum.MAINNET);
+```
+
+2. Build a withdrawal instruction for either PST (DepositMode.CLASSIC) or mPST (DepositMode.MAXI). At least 1 USDC worth of tokens must be withdrawn. Note that the withdrawal creates a redemption request and is not an instant redemption - withdrawals are typically processed within a few days, with a 7 day SLA at the latest.
+
+```
+import {
+  DepositMode
+} from "@huma-finance/permissionless-sdk";
+
+const tx = await client.buildWithdrawTx(
+    publicKey,
+    new BN(1000000), /* Withdraw 1 USDC worth of tokens */
+    DepositMode.CLASSIC /* Will redeem PST */
+);
+```
+
+3. The withdrawal transaction is intended to only handle the instructions for creating a redemption request. It should be up to the implementation to optimize the transaction with the correct blockhashes, compute unit limits, priority fees, etc.
+
+## Checking Token Price
+
+An example Node script integration in /examples/tokenPrice.ts is provided in this repo.
+
+1. Create a `PermissionlessClient` (same as depositing)
+
+```
+import {
+  PermissionlessClient,
+  SolanaChainEnum,
+} from "@huma-finance/permissionless-sdk";
+
+new PermissionlessClient(connection, SolanaChainEnum.MAINNET);
+```
+
+2. Get the current price of PST or mPST tokens denominated in the underlying mint (USDC)
+
+```
+import {
+  DepositMode
+} from "@huma-finance/permissionless-sdk";
+
+const price = await client.getModeTokenPrice(DepositMode.CLASSIC);
+console.log(price.toString()); // Price in smallest units of underlying mint
+```
+
+3. The price is returned as a BN representing the price in the smallest units of the underlying mint. For example, if the price is 1.234567 USDC, it will be returned as 1234567 (since USDC has 6 decimals).

package/dist/permissionless/client.d.ts

@@ -9,6 +9,10 @@ export declare class PermissionlessClient {
     private metadata;
     private program;
     constructor(connection: Connection, chain: SolanaChainEnum);
+    getModeTokenATA(owner: PublicKey, mode: DepositMode): Promise<PublicKey>;
     buildDepositTx(owner: PublicKey, amount: BN, mode: DepositMode, commitment?: DepositCommitment): Promise<Transaction>;
+    buildWithdrawTx(owner: PublicKey, amount: BN, mode: DepositMode): Promise<Transaction>;
+    getModeTokenPrice(mode: DepositMode): Promise<BN>;
+    private getCreateLenderStateAccountInstruction;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/permissionless/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/permissionless/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAkB,MAAM,mBAAmB,CAAC;AAQhE,OAAO,EAAE,EAAE,EAAwB,MAAM,mBAAmB,CAAC;AAG7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,OAAO,CAA0B;gBAE7B,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe;IAOpD,cAAc,CAClB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,EAAE,EACV,IAAI,EAAE,WAAW,EACjB,UAAU,GAAE,iBAA+C,GAC1D,OAAO,CAAC,WAAW,CAAC;CA2DxB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/permissionless/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,SAAS,EACT,WAAW,EAEZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAkB,MAAM,mBAAmB,CAAC;AAShE,OAAO,EAAE,EAAE,EAAwB,MAAM,mBAAmB,CAAC;AAG7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,OAAO,CAA0B;gBAE7B,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe;IAQpD,eAAe,CACnB,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,SAAS,CAAC;IAUf,cAAc,CAClB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,EAAE,EACV,IAAI,EAAE,WAAW,EACjB,UAAU,GAAE,iBAA+C,GAC1D,OAAO,CAAC,WAAW,CAAC;IAuDjB,eAAe,CACnB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,EAAE,EACV,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,WAAW,CAAC;IAwCjB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,EAAE,CAAC;YAkCzC,sCAAsC;CAqCrD"}

package/dist/permissionless/client.js

@@ -6,9 +6,11 @@ const metadata_1 = require("../types/metadata");
 const metadata_2 = require("../utils/metadata");
 const spl_token_1 = require("@solana/spl-token");
 const lenderAccount_1 = require("../utils/lenderAccount");
+const anchor_1 = require("@coral-xyz/anchor");
 const program_1 = require("../utils/program");
 const tokenAccount_1 = require("../utils/tokenAccount");
 const deposit_1 = require("../types/deposit");
+const redemptionRequestAccount_1 = require("../utils/redemptionRequestAccount");
 class PermissionlessClient {
     connection;
     chain;
@@ -20,9 +22,106 @@ class PermissionlessClient {
         this.metadata = (0, metadata_2.getMetadata)(chain);
         this.program = (0, program_1.getHumaProgram)(connection, chain);
     }
+    // Gets the associated token account (ATA) of the owner for the given mode
+    async getModeTokenATA(owner, mode) {
+        const modeMetadata = this.metadata[mode];
+        return (0, tokenAccount_1.getModeTokenATA)(owner, new web3_js_1.PublicKey(modeMetadata.mint));
+    }
+    // Returns a transaction with all the necessary instructions to deposit into
+    // Huma 2.0 for the given mode. Note that this transaction omits priority fees,
+    // compute unit limits, and recent blockhash as these should be added by the caller.
+    // Notes:
+    // - Minimum deposit amount is 1000000 (1 USDC)
     async buildDepositTx(owner, amount, mode, commitment = deposit_1.DepositCommitment.NO_COMMIT) {
         const modeMetadata = this.metadata[mode];
         const tx = new web3_js_1.Transaction();
+        const createLenderAccountInstruction = await this.getCreateLenderStateAccountInstruction(owner, mode);
+        if (createLenderAccountInstruction) {
+            tx.add(createLenderAccountInstruction);
+        }
+        const lenderModeTokenATA = (0, tokenAccount_1.getModeTokenATA)(owner, new web3_js_1.PublicKey(modeMetadata.mint));
+        tx.add((0, spl_token_1.createAssociatedTokenAccountIdempotentInstruction)(owner, lenderModeTokenATA, owner, new web3_js_1.PublicKey(modeMetadata.mint), spl_token_1.TOKEN_PROGRAM_ID));
+        const depositTx = await this.program.methods
+            .deposit(amount, commitment, false /* commitmentAutoRenewal */)
+            .accountsPartial({
+            depositor: owner,
+            humaConfig: this.metadata.humaConfig,
+            poolConfig: this.metadata.poolConfig,
+            modeConfig: modeMetadata.config,
+            underlyingMint: new web3_js_1.PublicKey(this.metadata.underlyingMint.address),
+            underlyingTokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+            modeTokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+        })
+            .instruction();
+        tx.add(depositTx);
+        return tx;
+    }
+    // Returns a transaction with all the necessary instructions to withdraw from
+    // Huma 2.0 for the given mode. Note that this transaction omits priority fees,
+    // compute unit limits, and recent blockhash as these should be added by the caller.
+    // Notes:
+    // - Minimum withdrawal amount is 1000000 (1 USDC)
+    // - The withdrawal creates a redemption request and is not an instant redemption.
+    //   Withdrawals are typically processed within a few days, and have a 7 day SLA at the latest.
+    // - Redemptions will transfer the mode token out of the wallet where they will be held
+    //   until processing is complete.
+    // - Redemption requests are processed in a FIFO queue. There is a daily redemption cap but this
+    //   will not prevent new requests from being added to the queue.
+    // - In rare cases a redemption request ID can collide with another request if both are submitted
+    //   at the same time. Only one of the requests will successfully create, and the other must
+    //   be regenerated with a new ID and resubmitted.
+    async buildWithdrawTx(owner, amount, mode) {
+        const modeMetadata = this.metadata[mode];
+        const tx = new web3_js_1.Transaction();
+        const createLenderAccountInstruction = await this.getCreateLenderStateAccountInstruction(owner, mode);
+        if (createLenderAccountInstruction) {
+            tx.add(createLenderAccountInstruction);
+        }
+        const { humaConfig, poolConfig } = this.metadata;
+        // Get the latest last request ID from the pool state account to avoid race condition as much as possible
+        const poolState = await this.program.account.poolState.fetch(new web3_js_1.PublicKey(this.metadata.poolState));
+        const { lastRequestId } = poolState.redemptionQueue;
+        const requestIdBN = new anchor_1.BN(lastRequestId).add(new anchor_1.BN(1));
+        const redemptionRequestPDA = (0, redemptionRequestAccount_1.getRedemptionRequestPDA)(new web3_js_1.PublicKey(poolConfig), new web3_js_1.PublicKey(this.metadata.poolProgram), requestIdBN);
+        const addRedemptionRequestInstruction = await this.program.methods
+            .addRedemptionRequest(new anchor_1.BN(amount))
+            .accountsPartial({
+            lender: owner,
+            humaConfig: humaConfig,
+            poolConfig: poolConfig,
+            modeConfig: modeMetadata.config,
+            redemptionRequest: redemptionRequestPDA,
+            tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+        })
+            .instruction();
+        tx.add(addRedemptionRequestInstruction);
+        return tx;
+    }
+    // Fetches the current native price of the mode token demoninated in the underlying mint
+    async getModeTokenPrice(mode) {
+        let modeStateIndex = 0;
+        if (mode === metadata_1.DepositMode.CLASSIC) {
+            modeStateIndex = 0;
+        }
+        else {
+            modeStateIndex = 1;
+        }
+        const modeMetadata = this.metadata[mode];
+        const [poolState, modeMint] = await Promise.all([
+            this.program.account.poolState.fetch(new web3_js_1.PublicKey(this.metadata.poolState)),
+            (0, spl_token_1.getMint)(this.connection, new web3_js_1.PublicKey(modeMetadata.mint), undefined, spl_token_1.TOKEN_PROGRAM_ID),
+        ]);
+        const assets = new anchor_1.BN(poolState.modeStates[modeStateIndex].assets);
+        const decimals = new anchor_1.BN(10).pow(new anchor_1.BN(this.metadata.underlyingMint.decimals));
+        const supply = new anchor_1.BN(modeMint.supply);
+        // Handle division by zero
+        if (supply.isZero()) {
+            return new anchor_1.BN(0);
+        }
+        return assets.mul(decimals).div(supply);
+    }
+    async getCreateLenderStateAccountInstruction(owner, mode) {
+        const modeMetadata = this.metadata[mode];
         const { classicLenderStateAccount, maxiLenderStateAccount } = await (0, lenderAccount_1.getLenderStateAccounts)(this.connection, owner, this.chain);
         const lenderModeTokenATA = (0, tokenAccount_1.getModeTokenATA)(owner, new web3_js_1.PublicKey(modeMetadata.mint));
         let lenderStateAccount;
@@ -44,23 +143,11 @@ class PermissionlessClient {
                 tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
             })
                 .instruction();
-            tx.add(createLenderAccountInstruction);
+            return createLenderAccountInstruction;
+        }
+        else {
+            return null;
         }
-        tx.add((0, spl_token_1.createAssociatedTokenAccountIdempotentInstruction)(owner, lenderModeTokenATA, owner, new web3_js_1.PublicKey(modeMetadata.mint), spl_token_1.TOKEN_PROGRAM_ID));
-        const depositTx = await this.program.methods
-            .deposit(amount, commitment, false /* commitmentAutoRenewal */)
-            .accountsPartial({
-            depositor: owner,
-            humaConfig: this.metadata.humaConfig,
-            poolConfig: this.metadata.poolConfig,
-            modeConfig: modeMetadata.config,
-            underlyingMint: new web3_js_1.PublicKey(this.metadata.underlyingMint.address),
-            underlyingTokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
-            modeTokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
-        })
-            .instruction();
-        tx.add(depositTx);
-        return tx;
     }
 }
 exports.PermissionlessClient = PermissionlessClient;

package/dist/permissionless/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/permissionless/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/permissionless/client.ts"],"names":[],"mappings":"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"}

package/dist/utils/redemptionRequestAccount.d.ts

@@ -0,0 +1,4 @@
+import { BN } from "@coral-xyz/anchor";
+import { PublicKey } from "@solana/web3.js";
+export declare const getRedemptionRequestPDA: (poolConfig: PublicKey, poolProgram: PublicKey, requestId: BN) => PublicKey;
+//# sourceMappingURL=redemptionRequestAccount.d.ts.map

package/dist/utils/redemptionRequestAccount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redemptionRequestAccount.d.ts","sourceRoot":"","sources":["../../src/utils/redemptionRequestAccount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,eAAO,MAAM,uBAAuB,GAClC,YAAY,SAAS,EACrB,aAAa,SAAS,EACtB,WAAW,EAAE,KACZ,SAUF,CAAC"}

package/dist/utils/redemptionRequestAccount.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRedemptionRequestPDA = void 0;
+const web3_js_1 = require("@solana/web3.js");
+const getRedemptionRequestPDA = (poolConfig, poolProgram, requestId) => {
+    const [PDA] = web3_js_1.PublicKey.findProgramAddressSync([
+        Buffer.from("redemption_request"),
+        requestId.toBuffer("be", 16),
+        poolConfig.toBuffer(),
+    ], new web3_js_1.PublicKey(poolProgram));
+    return PDA;
+};
+exports.getRedemptionRequestPDA = getRedemptionRequestPDA;
+//# sourceMappingURL=redemptionRequestAccount.js.map

package/dist/utils/redemptionRequestAccount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redemptionRequestAccount.js","sourceRoot":"","sources":["../../src/utils/redemptionRequestAccount.ts"],"names":[],"mappings":";;;AACA,6CAA4C;AAErC,MAAM,uBAAuB,GAAG,CACrC,UAAqB,EACrB,WAAsB,EACtB,SAAa,EACF,EAAE;IACb,MAAM,CAAC,GAAG,CAAC,GAAG,mBAAS,CAAC,sBAAsB,CAC5C;QACE,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC;QACjC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5B,UAAU,CAAC,QAAQ,EAAE;KACtB,EACD,IAAI,mBAAS,CAAC,WAAW,CAAC,CAC3B,CAAC;IACF,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAdW,QAAA,uBAAuB,2BAclC"}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@huma-finance/permissionless-sdk",
-  "version": "1.0.3",
+  "version": "1.0.4-beta.20250910221307.cf6362e",
   "description": "Huma Finance Permissionless SDK for Solana",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
-    "dist/**/*"
+    "dist/**/*",
+    "README.md"
   ],
   "publishConfig": {
     "access": "public"
@@ -20,16 +21,16 @@
   "author": "Huma Finance",
   "license": "MIT",
   "dependencies": {
-    "@coral-xyz/anchor": "^0.31.1",
-    "@solana/spl-token": "^0.4.14",
-    "@solana/web3.js": "^1.98.4"
+    "@coral-xyz/anchor": "0.31.1",
+    "@solana/spl-token": "0.4.14",
+    "@solana/web3.js": "1.98.4"
   },
   "devDependencies": {
-    "@types/jest": "^29.5.12",
-    "@types/node": "^24.3.0",
-    "dotenv": "^17.2.2",
-    "jest": "^29.7.0",
-    "ts-jest": "^29.1.2"
+    "@types/jest": "29.5.12",
+    "@types/node": "24.3.0",
+    "dotenv": "17.2.2",
+    "jest": "29.7.0",
+    "ts-jest": "29.1.2"
   },
   "scripts": {
     "build": "tsc",