northstar-eva-sdk 0.7.0 → 0.9.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)`, `buildCloseTrenchIx({ trenchId, creator? })`, `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;
@@ -457,6 +462,15 @@ export declare class NorthstarEva {
     buildClosePoolIx(p: {
         trenchId: bigint;
     }): Promise<TransactionInstruction>;
+    /**
+     * eva closeTrench instruction (ER) — close an **Ended** trench (post close_pool + distribute_prize),
+     * refunding the remaining lamports (rent + undistributed prize dust) to the trench **creator**.
+     * The trench's stored `creator` must sign (`has_one = creator`); defaults to the SDK signer.
+     */
+    buildCloseTrenchIx(p: {
+        trenchId: bigint;
+        creator?: PublicKey;
+    }): Promise<TransactionInstruction>;
     /** eva claimTokens instruction (ER, admin) — release `user`'s tokens from the trench vault to their ATA. */
     buildClaimTokensIx(p: {
         trenchId: bigint;
@@ -628,6 +642,11 @@ export declare class NorthstarEva {
     closePool(p: {
         trenchId: bigint;
     }): Promise<string>;
+    /** eva closeTrench (ER) — close an **Ended** trench, refunding remaining lamports to the creator (who signs). */
+    closeTrench(p: {
+        trenchId: bigint;
+        creator?: PublicKey;
+    }): Promise<string>;
     /** eva claimTokens (ER, admin) — release `user`'s tokens from the trench vault to their ATA. */
     claimTokens(p: {
         trenchId: bigint;

package/dist/northstar-eva-sdk.js

@@ -14,7 +14,7 @@ const __EVA_IDL__ = {
     "address": "CQru6EauVg2UwepFCvY5qWuqCPEWYC4ta43wBbkFYtmo",
     "metadata": {
         "name": "eva_arena",
-        "version": "0.1.4",
+        "version": "0.1.6",
         "spec": "0.1.0",
         "description": "Created with Anchor"
     },
@@ -381,6 +381,31 @@ const __EVA_IDL__ = {
             ],
             "args": []
         },
+        {
+            "name": "close_trench",
+            "discriminator": [
+                249,
+                176,
+                185,
+                73,
+                24,
+                59,
+                234,
+                84
+            ],
+            "accounts": [
+                {
+                    "name": "trench",
+                    "writable": true
+                },
+                {
+                    "name": "creator",
+                    "writable": true,
+                    "signer": true
+                }
+            ],
+            "args": []
+        },
         {
             "name": "create_trench",
             "discriminator": [
@@ -2478,9 +2503,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) {
@@ -2541,6 +2571,14 @@ export class NorthstarEva {
         const g = await this.requireGlobal();
         return this.methods.closePool().accounts({ trench: this.trenchPda(p.trenchId), globalState: this.globalStatePda(), feeRecipient: new PublicKey(g.feeRecipient), admin: this.payer }).instruction();
     }
+    /**
+     * eva closeTrench instruction (ER) — close an **Ended** trench (post close_pool + distribute_prize),
+     * refunding the remaining lamports (rent + undistributed prize dust) to the trench **creator**.
+     * The trench's stored `creator` must sign (`has_one = creator`); defaults to the SDK signer.
+     */
+    buildCloseTrenchIx(p) {
+        return this.methods.closeTrench().accounts({ trench: this.trenchPda(p.trenchId), creator: p.creator ?? this.payer }).instruction();
+    }
     /** eva claimTokens instruction (ER, admin) — release `user`'s tokens from the trench vault to their ATA. */
     buildClaimTokensIx(p) {
         const user = p.user ?? this.payer;
@@ -2775,6 +2813,10 @@ export class NorthstarEva {
     async closePool(p) {
         return this.sendEva(await this.buildClosePoolIx(p), "closePool");
     }
+    /** eva closeTrench (ER) — close an **Ended** trench, refunding remaining lamports to the creator (who signs). */
+    async closeTrench(p) {
+        return this.sendEva(await this.buildCloseTrenchIx(p), "closeTrench");
+    }
     /** eva claimTokens (ER, admin) — release `user`'s tokens from the trench vault to their ATA. */
     async claimTokens(p) {
         return this.sendEva(await this.buildClaimTokensIx(p), "claimTokens");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "northstar-eva-sdk",
-  "version": "0.7.0",
+  "version": "0.9.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",