northstar-eva-sdk 0.7.0 → 0.8.0

package/README.md

@@ -69,7 +69,7 @@ tx.sign(myKeypair);                       // or wallet.signTransaction(tx)
 await connection.sendRawTransaction(tx.serialize());
 ```
 
-Builders (each mirrors the send-method's inputs): `buildOpenSessionIx()`, `buildCloseSessionIx()`, `buildDepositFeeIx(lamports, recipient?)`, `buildWithdrawFeeFromErIx({ lamports, sender?, toL1? })` (Portal SOL bridge), `buildInitializeIx(p)`, `buildUpdateConfigIx(p)`, `buildCreateTrenchIx({ trenchId?, initialVirtualTokenReserves? })`, `buildDepositIx(p)`, `buildWithdrawIx({ trenchId, amount, thinkId? })` (eva trench withdraw), `buildFinalizeIx(p)`, `buildUserAtaIx(p)`, `buildBuyIx(p)`, `buildSellIx(p)`, `buildClosePoolIx(p)`, `buildClaimTokensIx(p)`, `buildDistributePrizeIx(p)`, plus `buildTransaction(ixs, { lane?, feePayer? })`, `nextTrenchId()`, and the `agentPda(id, user?)` PDA helper.
+Builders (each mirrors the send-method's inputs): `buildOpenSessionIx()`, `buildCloseSessionIx()`, `buildDepositFeeIx(lamports, recipient?, sender?)` (sender = the depositor/signer; defaults to the SDK signer), `buildWithdrawFeeFromErIx({ lamports, sender?, toL1? })` (Portal SOL bridge), `buildInitializeIx(p)`, `buildUpdateConfigIx(p)`, `buildCreateTrenchIx({ trenchId?, initialVirtualTokenReserves? })`, `buildDepositIx(p)`, `buildWithdrawIx({ trenchId, amount, thinkId? })` (eva trench withdraw), `buildFinalizeIx(p)`, `buildUserAtaIx(p)`, `buildBuyIx(p)`, `buildSellIx(p)`, `buildClosePoolIx(p)`, `buildClaimTokensIx(p)`, `buildDistributePrizeIx(p)`, plus `buildTransaction(ixs, { lane?, feePayer? })`, `nextTrenchId()`, and the `agentPda(id, user?)` PDA helper.
 
 > The existing send-methods (`buy`, `sell`, `fundFeeToErPayer`, …) are unchanged — they now just call these builders internally. Builders perform the same state **reads** to resolve accounts (e.g. `buildBuyIx` reads global for `feeRecipient`) but never **send**.
 

package/dist/northstar-eva-sdk.d.ts

@@ -389,8 +389,13 @@ export declare class NorthstarEva {
      * `const ix = await sdk.buildEnsureSessionIx(); if (ix) tx.add(ix);`
      */
     buildEnsureSessionIx(): Promise<TransactionInstruction | null>;
-    /** Portal DepositFee instruction (L1) — "fund fee to ER payer". (Caller must ensure a session exists.) */
-    buildDepositFeeIx(lamports: bigint, recipient?: PublicKey): TransactionInstruction;
+    /**
+     * Portal DepositFee instruction (L1) — "fund fee to ER payer". (Caller must ensure a session exists.)
+     * `sender` is the **depositor** — the account that pays the SOL on L1 and **must sign** the tx;
+     * defaults to the SDK signer, but pass it explicitly for user-signed flows (don't rely on the default).
+     * `recipient` is the account credited on the ER (defaults to the SDK signer).
+     */
+    buildDepositFeeIx(lamports: bigint, recipient?: PublicKey, sender?: PublicKey): TransactionInstruction;
     /** "Withdraw fee from ER" instruction (ER) — system transfer from `sender` (default: the signer) → its WithdrawalSink. (Portal SOL bridge; distinct from the eva `withdraw` instruction.) */
     buildWithdrawFeeFromErIx(p: {
         lamports: bigint;

package/dist/northstar-eva-sdk.js

@@ -2478,9 +2478,14 @@ export class NorthstarEva {
             return null; // already created
         return this.buildOpenSessionIx();
     }
-    /** Portal DepositFee instruction (L1) — "fund fee to ER payer". (Caller must ensure a session exists.) */
-    buildDepositFeeIx(lamports, recipient = this.payer) {
-        return portal.depositFeeIx({ programId: this.cfg.portalProgramId, depositor: this.payer, recipient, lamports });
+    /**
+     * Portal DepositFee instruction (L1) — "fund fee to ER payer". (Caller must ensure a session exists.)
+     * `sender` is the **depositor** — the account that pays the SOL on L1 and **must sign** the tx;
+     * defaults to the SDK signer, but pass it explicitly for user-signed flows (don't rely on the default).
+     * `recipient` is the account credited on the ER (defaults to the SDK signer).
+     */
+    buildDepositFeeIx(lamports, recipient = this.payer, sender = this.payer) {
+        return portal.depositFeeIx({ programId: this.cfg.portalProgramId, depositor: sender, recipient, lamports });
     }
     /** "Withdraw fee from ER" instruction (ER) — system transfer from `sender` (default: the signer) → its WithdrawalSink. (Portal SOL bridge; distinct from the eva `withdraw` instruction.) */
     buildWithdrawFeeFromErIx(p) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "northstar-eva-sdk",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Run the eva program on a NorthStar ephemeral rollup (zero-fee hot path). A high-level class SDK over the NorthStar Portal/ER protocol + the eva Anchor program. Works localnet & devnet.",
   "type": "module",
   "license": "MIT",