@perena/vault-sdk 1.0.18 → 1.0.19

package/README.md

@@ -152,6 +152,9 @@ const ixArgs = {
   feeVault,
   feeVaultAta,
   userShareAta,
+  // Optional: selects execute_deposit_fee_exempt and is included in ix data.
+  // Include every invoke_signed seed, with the bump as the final seed.
+  addressSeeds,
 };
 
 const accounts = client.tx.executeDeposit.getIxAccounts(ixArgs);
@@ -167,21 +170,65 @@ const cpiPayload = {
   ),
   data: {
     amount: data.amount.toString(),
+    addressSeeds: data.addressSeeds,
   },
 };
 ```
 
 In Rust, map those account addresses into the matching Anchor CPI account struct
 and pass the data fields into the generated CPI method. For example,
-`executeDeposit.getIxData(...)` returns `{ amount }`, which corresponds to the
-`amount` argument on the vault program's `execute_deposit` CPI.
+`executeDeposit.getIxData(...)` returns `{ amount, addressSeeds }`. Without
+`addressSeeds`, it corresponds to `execute_deposit`; with seeds, the builder
+selects `execute_deposit_fee_exempt`.
+
+### Fee-exempt program integrations
+
+The deposit, withdrawal, tranche deposit, tranche withdrawal, and queued junior
+fulfillment builders accept optional `addressSeeds` in both their `TxArgs` and
+resolved `IxArgs`. Providing this field selects the corresponding
+`*_fee_exempt` instruction; omitting it always selects the standard fee-bearing
+instruction. External-liquidity withdrawals select
+`execute_withdraw_from_external_fee_exempt` when both external withdrawal data
+and `addressSeeds` are present.
+
+Pass the exact seed slices used by the integrating program's `invoke_signed`,
+including the one-byte bump as the final seed:
+
+```typescript
+import { PublicKey } from "@solana/web3.js";
+
+const baseSeeds = [Buffer.from("authority"), new PublicKey(vault).toBuffer()];
+const [authority, bump] = PublicKey.findProgramAddressSync(
+  baseSeeds,
+  integrationProgramId
+);
+const addressSeeds = [...baseSeeds, Buffer.from([bump])];
+
+const ixArgs = await client.tx.executeDeposit.getIxData({
+  ...resolvedDepositIxArgs,
+  user: authority.toBase58() as Address,
+  addressSeeds,
+});
+
+// ixArgs.addressSeeds is forwarded to execute_deposit_fee_exempt.
+```
+
+On-chain exemption succeeds only when the authority is a signer, its owner is
+the vault program or an allowlisted integration program, and
+`create_program_address(addressSeeds, authority.owner)` equals the authority
+address. The integrating program must invoke the vault instruction using
+`invoke_signed` with those same seeds. A PDA cannot call the fee-exempt route as
+a directly submitted top-level transaction.
+
+For `fulfillJuniorTrancheWithdraw`, the fee-exempt signer must also be the queue
+owner; a separate fulfiller cannot waive that owner's fee.
 
 ## Quoting conversions
 
 Use `client.quote.quote(...)` to calculate expected output amounts before
-building a transaction. Quotes fetch the current vault/tranche state, calculate
-using the same fee formulas as the program, and require a `signer` address so
-the SDK can check whether the signer is owned by a fee-exempt program.
+building a transaction. Quotes fetch the current vault/tranche state and use the
+same fee formulas as the program. To quote a fee-exempt route, provide the same
+`addressSeeds`; owner allowlisting by itself does not make a quote fee-exempt.
 
 All amounts are base units. `expectedAmountOut` is the net amount after fees;
 `grossAmountOut`, `feeAmount`, `feeBps`, and `feeExempt` explain the quote.
@@ -200,7 +247,17 @@ const depositQuote = await client.quote.quote({
 });
 
 console.log(depositQuote.expectedAmountOut); // regular shares to receive
-console.log(depositQuote.feeExempt); // true when signer owner is whitelisted
+console.log(depositQuote.feeExempt); // false: no addressSeeds were supplied
+
+const exemptDepositQuote = await client.quote.quote({
+  shareClass: "regular",
+  direction: "deposit",
+  signer,
+  vault,
+  assetMint,
+  amount: 1_000_000n,
+  addressSeeds,
+});
 
 // Regular vault shares -> asset
 const withdrawQuote = await client.quote.quote({
@@ -331,7 +388,6 @@ await client.sendTransaction(
     curator,
     shareMint,
     strictAssetMint: assetMint,
-    assetDecimals: 6,
   })
 );