northstar-eva-sdk 0.1.0

package/dist/northstar-eva-sdk.js

@@ -0,0 +1,2473 @@
+/* eslint-disable */
+// ============================================================================
+//  northstar-eva-sdk — SINGLE-FILE BUILD (generated; do not edit by hand)
+//  Drop this file in, then: npm i @solana/web3.js @coral-xyz/anchor @solana/spl-token
+//  Usage: import { NorthstarEva } from "./northstar-eva-sdk.single.ts";
+//  Source of truth: northstar-eva-sdk/src/*  — regenerate with: npm run bundle
+// ============================================================================
+import * as anchor from "@coral-xyz/anchor";
+import { readFileSync } from "node:fs";
+import { Connection, Keypair, PublicKey, SystemProgram, Transaction, TransactionInstruction, sendAndConfirmTransaction } from "@solana/web3.js";
+import { TOKEN_PROGRAM_ID, ASSOCIATED_TOKEN_PROGRAM_ID, getAssociatedTokenAddressSync, createAssociatedTokenAccountIdempotentInstruction } from "@solana/spl-token";
+// --- embedded eva IDL (CQru6…) ---
+const __EVA_IDL__ = {
+    "address": "CQru6EauVg2UwepFCvY5qWuqCPEWYC4ta43wBbkFYtmo",
+    "metadata": {
+        "name": "eva_arena",
+        "version": "0.1.4",
+        "spec": "0.1.0",
+        "description": "Created with Anchor"
+    },
+    "instructions": [
+        {
+            "name": "buy",
+            "discriminator": [
+                102,
+                6,
+                61,
+                18,
+                1,
+                218,
+                235,
+                234
+            ],
+            "accounts": [
+                {
+                    "name": "trench",
+                    "writable": true
+                },
+                {
+                    "name": "global_state",
+                    "writable": true
+                },
+                {
+                    "name": "fee_recipient",
+                    "writable": true
+                },
+                {
+                    "name": "user",
+                    "writable": true,
+                    "signer": true
+                },
+                {
+                    "name": "trench_token_vault",
+                    "docs": [
+                        "Vault holding trench's tokens (ATA owned by trench)"
+                    ],
+                    "writable": true,
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "account",
+                                "path": "trench"
+                            },
+                            {
+                                "kind": "const",
+                                "value": [
+                                    6,
+                                    221,
+                                    246,
+                                    225,
+                                    215,
+                                    101,
+                                    161,
+                                    147,
+                                    217,
+                                    203,
+                                    225,
+                                    70,
+                                    206,
+                                    235,
+                                    121,
+                                    172,
+                                    28,
+                                    180,
+                                    133,
+                                    237,
+                                    95,
+                                    91,
+                                    55,
+                                    145,
+                                    58,
+                                    140,
+                                    245,
+                                    133,
+                                    126,
+                                    255,
+                                    0,
+                                    169
+                                ]
+                            },
+                            {
+                                "kind": "account",
+                                "path": "trench.token_mint",
+                                "account": "Trench"
+                            }
+                        ],
+                        "program": {
+                            "kind": "const",
+                            "value": [
+                                140,
+                                151,
+                                37,
+                                143,
+                                78,
+                                36,
+                                137,
+                                241,
+                                187,
+                                61,
+                                16,
+                                41,
+                                20,
+                                142,
+                                13,
+                                131,
+                                11,
+                                90,
+                                19,
+                                153,
+                                218,
+                                255,
+                                16,
+                                132,
+                                4,
+                                142,
+                                123,
+                                216,
+                                219,
+                                233,
+                                248,
+                                89
+                            ]
+                        }
+                    }
+                },
+                {
+                    "name": "user_token_account",
+                    "docs": [
+                        "User's token account (must match trench's token mint)"
+                    ],
+                    "writable": true
+                },
+                {
+                    "name": "system_program",
+                    "address": "11111111111111111111111111111111"
+                },
+                {
+                    "name": "token_program",
+                    "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+                }
+            ],
+            "args": [
+                {
+                    "name": "sol_pay_with_fee",
+                    "type": "u64"
+                },
+                {
+                    "name": "think_id",
+                    "type": "u64"
+                }
+            ]
+        },
+        {
+            "name": "claim_tokens",
+            "discriminator": [
+                108,
+                216,
+                210,
+                231,
+                0,
+                212,
+                42,
+                64
+            ],
+            "accounts": [
+                {
+                    "name": "global_state",
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const",
+                                "value": [
+                                    103,
+                                    108,
+                                    111,
+                                    98,
+                                    97,
+                                    108
+                                ]
+                            }
+                        ]
+                    }
+                },
+                {
+                    "name": "trench",
+                    "writable": true
+                },
+                {
+                    "name": "agent",
+                    "writable": true,
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const",
+                                "value": [
+                                    97,
+                                    103,
+                                    101,
+                                    110,
+                                    116
+                                ]
+                            },
+                            {
+                                "kind": "account",
+                                "path": "trench"
+                            },
+                            {
+                                "kind": "account",
+                                "path": "user"
+                            }
+                        ]
+                    }
+                },
+                {
+                    "name": "user"
+                },
+                {
+                    "name": "admin",
+                    "docs": [
+                        "Admin who can claim tokens for user"
+                    ],
+                    "writable": true,
+                    "signer": true
+                },
+                {
+                    "name": "trench_token_vault",
+                    "writable": true,
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "account",
+                                "path": "trench"
+                            },
+                            {
+                                "kind": "const",
+                                "value": [
+                                    6,
+                                    221,
+                                    246,
+                                    225,
+                                    215,
+                                    101,
+                                    161,
+                                    147,
+                                    217,
+                                    203,
+                                    225,
+                                    70,
+                                    206,
+                                    235,
+                                    121,
+                                    172,
+                                    28,
+                                    180,
+                                    133,
+                                    237,
+                                    95,
+                                    91,
+                                    55,
+                                    145,
+                                    58,
+                                    140,
+                                    245,
+                                    133,
+                                    126,
+                                    255,
+                                    0,
+                                    169
+                                ]
+                            },
+                            {
+                                "kind": "account",
+                                "path": "trench.token_mint",
+                                "account": "Trench"
+                            }
+                        ],
+                        "program": {
+                            "kind": "const",
+                            "value": [
+                                140,
+                                151,
+                                37,
+                                143,
+                                78,
+                                36,
+                                137,
+                                241,
+                                187,
+                                61,
+                                16,
+                                41,
+                                20,
+                                142,
+                                13,
+                                131,
+                                11,
+                                90,
+                                19,
+                                153,
+                                218,
+                                255,
+                                16,
+                                132,
+                                4,
+                                142,
+                                123,
+                                216,
+                                219,
+                                233,
+                                248,
+                                89
+                            ]
+                        }
+                    }
+                },
+                {
+                    "name": "user_token_account",
+                    "writable": true
+                },
+                {
+                    "name": "token_program",
+                    "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+                }
+            ],
+            "args": []
+        },
+        {
+            "name": "close_pool",
+            "discriminator": [
+                140,
+                189,
+                209,
+                23,
+                239,
+                62,
+                239,
+                11
+            ],
+            "accounts": [
+                {
+                    "name": "trench",
+                    "writable": true
+                },
+                {
+                    "name": "global_state",
+                    "writable": true
+                },
+                {
+                    "name": "fee_recipient",
+                    "writable": true
+                },
+                {
+                    "name": "admin",
+                    "writable": true,
+                    "signer": true
+                },
+                {
+                    "name": "system_program",
+                    "address": "11111111111111111111111111111111"
+                }
+            ],
+            "args": []
+        },
+        {
+            "name": "create_trench",
+            "discriminator": [
+                66,
+                74,
+                73,
+                171,
+                206,
+                39,
+                116,
+                230
+            ],
+            "accounts": [
+                {
+                    "name": "global_state",
+                    "writable": true
+                },
+                {
+                    "name": "trench",
+                    "writable": true,
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const",
+                                "value": [
+                                    116,
+                                    114,
+                                    101,
+                                    110,
+                                    99,
+                                    104
+                                ]
+                            },
+                            {
+                                "kind": "arg",
+                                "path": "id"
+                            }
+                        ]
+                    }
+                },
+                {
+                    "name": "token_mint",
+                    "writable": true,
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const",
+                                "value": [
+                                    109,
+                                    105,
+                                    110,
+                                    116
+                                ]
+                            },
+                            {
+                                "kind": "account",
+                                "path": "trench"
+                            }
+                        ]
+                    }
+                },
+                {
+                    "name": "token_vault",
+                    "writable": true,
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "account",
+                                "path": "trench"
+                            },
+                            {
+                                "kind": "const",
+                                "value": [
+                                    6,
+                                    221,
+                                    246,
+                                    225,
+                                    215,
+                                    101,
+                                    161,
+                                    147,
+                                    217,
+                                    203,
+                                    225,
+                                    70,
+                                    206,
+                                    235,
+                                    121,
+                                    172,
+                                    28,
+                                    180,
+                                    133,
+                                    237,
+                                    95,
+                                    91,
+                                    55,
+                                    145,
+                                    58,
+                                    140,
+                                    245,
+                                    133,
+                                    126,
+                                    255,
+                                    0,
+                                    169
+                                ]
+                            },
+                            {
+                                "kind": "account",
+                                "path": "token_mint"
+                            }
+                        ],
+                        "program": {
+                            "kind": "const",
+                            "value": [
+                                140,
+                                151,
+                                37,
+                                143,
+                                78,
+                                36,
+                                137,
+                                241,
+                                187,
+                                61,
+                                16,
+                                41,
+                                20,
+                                142,
+                                13,
+                                131,
+                                11,
+                                90,
+                                19,
+                                153,
+                                218,
+                                255,
+                                16,
+                                132,
+                                4,
+                                142,
+                                123,
+                                216,
+                                219,
+                                233,
+                                248,
+                                89
+                            ]
+                        }
+                    }
+                },
+                {
+                    "name": "creator",
+                    "writable": true,
+                    "signer": true
+                },
+                {
+                    "name": "system_program",
+                    "address": "11111111111111111111111111111111"
+                },
+                {
+                    "name": "token_program",
+                    "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+                },
+                {
+                    "name": "associated_token_program",
+                    "address": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
+                },
+                {
+                    "name": "rent",
+                    "address": "SysvarRent111111111111111111111111111111111"
+                }
+            ],
+            "args": [
+                {
+                    "name": "id",
+                    "type": "u64"
+                },
+                {
+                    "name": "initial_virtual_token_reserves",
+                    "type": "u64"
+                }
+            ]
+        },
+        {
+            "name": "deposit",
+            "discriminator": [
+                242,
+                35,
+                198,
+                137,
+                82,
+                225,
+                242,
+                182
+            ],
+            "accounts": [
+                {
+                    "name": "trench",
+                    "writable": true
+                },
+                {
+                    "name": "agent",
+                    "writable": true,
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const",
+                                "value": [
+                                    97,
+                                    103,
+                                    101,
+                                    110,
+                                    116
+                                ]
+                            },
+                            {
+                                "kind": "account",
+                                "path": "trench"
+                            },
+                            {
+                                "kind": "account",
+                                "path": "user"
+                            }
+                        ]
+                    }
+                },
+                {
+                    "name": "user",
+                    "writable": true,
+                    "signer": true
+                },
+                {
+                    "name": "system_program",
+                    "address": "11111111111111111111111111111111"
+                }
+            ],
+            "args": [
+                {
+                    "name": "amount",
+                    "type": "u64"
+                },
+                {
+                    "name": "think_id",
+                    "type": "u64"
+                }
+            ]
+        },
+        {
+            "name": "distribute_prize",
+            "discriminator": [
+                153,
+                175,
+                67,
+                111,
+                205,
+                207,
+                106,
+                15
+            ],
+            "accounts": [
+                {
+                    "name": "trench",
+                    "writable": true
+                },
+                {
+                    "name": "global_state",
+                    "writable": true
+                },
+                {
+                    "name": "fee_recipient",
+                    "writable": true
+                },
+                {
+                    "name": "admin",
+                    "writable": true,
+                    "signer": true
+                },
+                {
+                    "name": "system_program",
+                    "address": "11111111111111111111111111111111"
+                }
+            ],
+            "args": [
+                {
+                    "name": "winners",
+                    "type": {
+                        "vec": "pubkey"
+                    }
+                },
+                {
+                    "name": "amounts",
+                    "type": {
+                        "vec": "u64"
+                    }
+                }
+            ]
+        },
+        {
+            "name": "finalize",
+            "discriminator": [
+                171,
+                61,
+                218,
+                56,
+                127,
+                115,
+                12,
+                217
+            ],
+            "accounts": [
+                {
+                    "name": "trench",
+                    "writable": true
+                },
+                {
+                    "name": "global_state",
+                    "writable": true
+                },
+                {
+                    "name": "fee_recipient",
+                    "writable": true
+                },
+                {
+                    "name": "admin",
+                    "writable": true,
+                    "signer": true
+                },
+                {
+                    "name": "system_program",
+                    "address": "11111111111111111111111111111111"
+                },
+                {
+                    "name": "token_program",
+                    "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+                },
+                {
+                    "name": "rent",
+                    "address": "SysvarRent111111111111111111111111111111111"
+                }
+            ],
+            "args": []
+        },
+        {
+            "name": "initialize",
+            "discriminator": [
+                175,
+                175,
+                109,
+                31,
+                13,
+                152,
+                155,
+                237
+            ],
+            "accounts": [
+                {
+                    "name": "global_state",
+                    "writable": true,
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const",
+                                "value": [
+                                    103,
+                                    108,
+                                    111,
+                                    98,
+                                    97,
+                                    108
+                                ]
+                            }
+                        ]
+                    }
+                },
+                {
+                    "name": "admin",
+                    "writable": true,
+                    "signer": true
+                },
+                {
+                    "name": "system_program",
+                    "address": "11111111111111111111111111111111"
+                }
+            ],
+            "args": [
+                {
+                    "name": "bidding_duration",
+                    "type": "u64"
+                },
+                {
+                    "name": "trading_duration",
+                    "type": "u64"
+                }
+            ]
+        },
+        {
+            "name": "sell",
+            "discriminator": [
+                51,
+                230,
+                133,
+                164,
+                1,
+                127,
+                131,
+                173
+            ],
+            "accounts": [
+                {
+                    "name": "trench",
+                    "writable": true
+                },
+                {
+                    "name": "global_state",
+                    "writable": true
+                },
+                {
+                    "name": "fee_recipient",
+                    "writable": true
+                },
+                {
+                    "name": "user",
+                    "writable": true,
+                    "signer": true
+                },
+                {
+                    "name": "trench_token_vault",
+                    "docs": [
+                        "Vault holding trench's tokens (ATA owned by trench)"
+                    ],
+                    "writable": true,
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "account",
+                                "path": "trench"
+                            },
+                            {
+                                "kind": "const",
+                                "value": [
+                                    6,
+                                    221,
+                                    246,
+                                    225,
+                                    215,
+                                    101,
+                                    161,
+                                    147,
+                                    217,
+                                    203,
+                                    225,
+                                    70,
+                                    206,
+                                    235,
+                                    121,
+                                    172,
+                                    28,
+                                    180,
+                                    133,
+                                    237,
+                                    95,
+                                    91,
+                                    55,
+                                    145,
+                                    58,
+                                    140,
+                                    245,
+                                    133,
+                                    126,
+                                    255,
+                                    0,
+                                    169
+                                ]
+                            },
+                            {
+                                "kind": "account",
+                                "path": "trench.token_mint",
+                                "account": "Trench"
+                            }
+                        ],
+                        "program": {
+                            "kind": "const",
+                            "value": [
+                                140,
+                                151,
+                                37,
+                                143,
+                                78,
+                                36,
+                                137,
+                                241,
+                                187,
+                                61,
+                                16,
+                                41,
+                                20,
+                                142,
+                                13,
+                                131,
+                                11,
+                                90,
+                                19,
+                                153,
+                                218,
+                                255,
+                                16,
+                                132,
+                                4,
+                                142,
+                                123,
+                                216,
+                                219,
+                                233,
+                                248,
+                                89
+                            ]
+                        }
+                    }
+                },
+                {
+                    "name": "user_token_account",
+                    "docs": [
+                        "User's token account (must match trench's token mint)"
+                    ],
+                    "writable": true
+                },
+                {
+                    "name": "token_program",
+                    "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+                }
+            ],
+            "args": [
+                {
+                    "name": "amount_in",
+                    "type": "u64"
+                },
+                {
+                    "name": "min_sol_output",
+                    "type": "u64"
+                },
+                {
+                    "name": "think_id",
+                    "type": "u64"
+                }
+            ]
+        },
+        {
+            "name": "update_config",
+            "discriminator": [
+                29,
+                158,
+                252,
+                191,
+                10,
+                83,
+                219,
+                99
+            ],
+            "accounts": [
+                {
+                    "name": "global_state",
+                    "writable": true,
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const",
+                                "value": [
+                                    103,
+                                    108,
+                                    111,
+                                    98,
+                                    97,
+                                    108
+                                ]
+                            }
+                        ]
+                    }
+                },
+                {
+                    "name": "admin",
+                    "writable": true,
+                    "signer": true
+                }
+            ],
+            "args": [
+                {
+                    "name": "bidding_duration",
+                    "type": "u64"
+                },
+                {
+                    "name": "trading_duration",
+                    "type": "u64"
+                },
+                {
+                    "name": "fee_recipient",
+                    "type": "pubkey"
+                }
+            ]
+        },
+        {
+            "name": "withdraw",
+            "discriminator": [
+                183,
+                18,
+                70,
+                156,
+                148,
+                109,
+                161,
+                34
+            ],
+            "accounts": [
+                {
+                    "name": "trench",
+                    "writable": true
+                },
+                {
+                    "name": "agent",
+                    "writable": true,
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const",
+                                "value": [
+                                    97,
+                                    103,
+                                    101,
+                                    110,
+                                    116
+                                ]
+                            },
+                            {
+                                "kind": "account",
+                                "path": "trench"
+                            },
+                            {
+                                "kind": "account",
+                                "path": "user"
+                            }
+                        ]
+                    }
+                },
+                {
+                    "name": "user",
+                    "writable": true,
+                    "signer": true
+                },
+                {
+                    "name": "system_program",
+                    "address": "11111111111111111111111111111111"
+                }
+            ],
+            "args": [
+                {
+                    "name": "amount",
+                    "type": "u64"
+                },
+                {
+                    "name": "think_id",
+                    "type": "u64"
+                }
+            ]
+        }
+    ],
+    "accounts": [
+        {
+            "name": "Agent",
+            "discriminator": [
+                47,
+                166,
+                112,
+                147,
+                155,
+                197,
+                86,
+                7
+            ]
+        },
+        {
+            "name": "GlobalState",
+            "discriminator": [
+                163,
+                46,
+                74,
+                168,
+                216,
+                123,
+                133,
+                98
+            ]
+        },
+        {
+            "name": "Trench",
+            "discriminator": [
+                70,
+                8,
+                211,
+                194,
+                255,
+                64,
+                8,
+                102
+            ]
+        }
+    ],
+    "events": [
+        {
+            "name": "BuyEvent",
+            "discriminator": [
+                103,
+                244,
+                82,
+                31,
+                44,
+                245,
+                119,
+                119
+            ]
+        },
+        {
+            "name": "ClaimTokensEvent",
+            "discriminator": [
+                71,
+                156,
+                103,
+                32,
+                16,
+                211,
+                150,
+                191
+            ]
+        },
+        {
+            "name": "ClosePoolEvent",
+            "discriminator": [
+                242,
+                151,
+                109,
+                158,
+                250,
+                231,
+                235,
+                140
+            ]
+        },
+        {
+            "name": "CreateTrenchEvent",
+            "discriminator": [
+                24,
+                172,
+                85,
+                31,
+                101,
+                75,
+                32,
+                122
+            ]
+        },
+        {
+            "name": "DepositEvent",
+            "discriminator": [
+                120,
+                248,
+                61,
+                83,
+                31,
+                142,
+                107,
+                144
+            ]
+        },
+        {
+            "name": "DistributePrizeEvent",
+            "discriminator": [
+                10,
+                83,
+                171,
+                140,
+                12,
+                201,
+                34,
+                128
+            ]
+        },
+        {
+            "name": "FinalizeEvent",
+            "discriminator": [
+                115,
+                140,
+                131,
+                4,
+                181,
+                52,
+                170,
+                148
+            ]
+        },
+        {
+            "name": "InitializeEvent",
+            "discriminator": [
+                206,
+                175,
+                169,
+                208,
+                241,
+                210,
+                35,
+                221
+            ]
+        },
+        {
+            "name": "SellEvent",
+            "discriminator": [
+                62,
+                47,
+                55,
+                10,
+                165,
+                3,
+                220,
+                42
+            ]
+        },
+        {
+            "name": "WithdrawEvent",
+            "discriminator": [
+                22,
+                9,
+                133,
+                26,
+                160,
+                44,
+                71,
+                192
+            ]
+        }
+    ],
+    "errors": [
+        {
+            "code": 6000,
+            "name": "NotBiddingPhase",
+            "msg": "Trench is not in bidding phase"
+        },
+        {
+            "code": 6001,
+            "name": "NotTradingPhase",
+            "msg": "Trench is not in trading phase"
+        },
+        {
+            "code": 6002,
+            "name": "InsufficientFunds",
+            "msg": "Insufficient funds"
+        },
+        {
+            "code": 6003,
+            "name": "SlippageExceeded",
+            "msg": "Slippage tolerance exceeded"
+        },
+        {
+            "code": 6004,
+            "name": "Overflow",
+            "msg": "Calculation overflow"
+        },
+        {
+            "code": 6005,
+            "name": "InvalidAmount",
+            "msg": "Invalid amount"
+        },
+        {
+            "code": 6006,
+            "name": "Unauthorized",
+            "msg": "Unauthorized access"
+        },
+        {
+            "code": 6007,
+            "name": "MathOverflow",
+            "msg": "Math operation overflow"
+        },
+        {
+            "code": 6008,
+            "name": "InvalidStatus",
+            "msg": "Invalid status"
+        },
+        {
+            "code": 6009,
+            "name": "AlreadyClaimed",
+            "msg": "Tokens already claimed"
+        },
+        {
+            "code": 6010,
+            "name": "TradingPhaseNotEnded",
+            "msg": "Trading phase not ended"
+        },
+        {
+            "code": 6011,
+            "name": "NoLiquidity",
+            "msg": "No liquidity available"
+        },
+        {
+            "code": 6012,
+            "name": "InvalidTrenchId",
+            "msg": "Invalid trench id"
+        }
+    ],
+    "types": [
+        {
+            "name": "Agent",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "authority",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "trench",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "deposited_sol",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "token_balance",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "is_claimed",
+                        "type": "bool"
+                    },
+                    {
+                        "name": "bump",
+                        "type": "u8"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "BuyEvent",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "trench",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "user",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "sol_amount",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "token_amount",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "trench_balance",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "think_id",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    },
+                    {
+                        "name": "pre_virtual_sol_reserves",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "pre_virtual_token_reserves",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "pre_real_sol_reserves",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "pre_real_token_reserves",
+                        "type": "u64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "ClaimTokensEvent",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "trench",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "user",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "amount",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "ClosePoolEvent",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "trench",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "sol_removed",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "CreateTrenchEvent",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "trench",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "creator",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "id",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "DepositEvent",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "trench",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "user",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "amount",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "user_deposited",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "total_deposited",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "trench_balance",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    },
+                    {
+                        "name": "think_id",
+                        "type": "u64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "DistributePrizeEvent",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "trench",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "winners",
+                        "type": {
+                            "vec": "pubkey"
+                        }
+                    },
+                    {
+                        "name": "amounts",
+                        "type": {
+                            "vec": "u64"
+                        }
+                    },
+                    {
+                        "name": "total_winners",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "FinalizeEvent",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "trench",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "sol_for_lp",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "tokens_for_lp",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "GlobalState",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "admin",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "fee_recipient",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "total_trenches",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "bidding_duration",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "trading_duration",
+                        "type": "u64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "InitializeEvent",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "admin",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "SellEvent",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "trench",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "user",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "sol_amount",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "token_amount",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "trench_balance",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "think_id",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    },
+                    {
+                        "name": "pre_virtual_sol_reserves",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "pre_virtual_token_reserves",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "pre_real_sol_reserves",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "pre_real_token_reserves",
+                        "type": "u64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "Trench",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "id",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "creator",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "authority",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "status",
+                        "type": {
+                            "defined": {
+                                "name": "TrenchStatus"
+                            }
+                        }
+                    },
+                    {
+                        "name": "total_deposited_sol",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "virtual_sol_reserves",
+                        "type": "u128"
+                    },
+                    {
+                        "name": "virtual_token_reserves",
+                        "type": "u128"
+                    },
+                    {
+                        "name": "real_sol_reserves",
+                        "type": "u128"
+                    },
+                    {
+                        "name": "real_token_reserves",
+                        "type": "u128"
+                    },
+                    {
+                        "name": "initial_virtual_token_reserves",
+                        "type": "u128"
+                    },
+                    {
+                        "name": "bidding_start_block",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "bidding_end_block",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "trading_end_block",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "token_mint",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "start_time",
+                        "type": "i64"
+                    },
+                    {
+                        "name": "prize_pool_reserves",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "bump",
+                        "type": "u8"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "TrenchStatus",
+            "type": {
+                "kind": "enum",
+                "variants": [
+                    {
+                        "name": "Bidding"
+                    },
+                    {
+                        "name": "Trading"
+                    },
+                    {
+                        "name": "Ended"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "WithdrawEvent",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "trench",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "user",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "amount",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "user_deposited",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "total_deposited",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "trench_balance",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    },
+                    {
+                        "name": "think_id",
+                        "type": "u64"
+                    }
+                ]
+            }
+        }
+    ]
+};
+/** tokens out for `solAmount` lamports in (ceil division — favors the pool). */
+export function getBuyPrice(amm, solAmount) {
+    if (amm.virtualSolReserves === 0n || amm.virtualTokenReserves === 0n)
+        return null;
+    const k = amm.virtualSolReserves * amm.virtualTokenReserves;
+    const newVSol = amm.virtualSolReserves + solAmount;
+    if (newVSol === 0n)
+        return null;
+    const quotient = k / newVSol;
+    const remainder = k % newVSol;
+    const newVToken = remainder > 0n ? quotient + 1n : quotient;
+    const tokensOut = amm.virtualTokenReserves - newVToken;
+    if (tokensOut <= 0n)
+        return null;
+    return tokensOut;
+}
+export function applyBuy(amm, solAmount) {
+    const tokenAmount = getBuyPrice(amm, solAmount);
+    if (tokenAmount === null)
+        return null;
+    if (amm.realTokenReserves - tokenAmount < 0n)
+        return null;
+    return {
+        result: { tokenAmount, solAmount },
+        reserves: {
+            virtualSolReserves: amm.virtualSolReserves + solAmount,
+            virtualTokenReserves: amm.virtualTokenReserves - tokenAmount,
+            realSolReserves: amm.realSolReserves + solAmount,
+            realTokenReserves: amm.realTokenReserves - tokenAmount,
+            initialVirtualTokenReserves: amm.initialVirtualTokenReserves,
+        },
+    };
+}
+/** SOL out for `tokens` in (floor division, capped by real SOL). */
+export function getSellPrice(amm, tokens) {
+    if (tokens === 0n || amm.realSolReserves === 0n)
+        return null;
+    const k = amm.virtualSolReserves * amm.virtualTokenReserves;
+    const newVToken = amm.virtualTokenReserves + tokens;
+    if (newVToken === 0n)
+        return null;
+    const newVSol = k / newVToken;
+    const solReceived = amm.virtualSolReserves - newVSol;
+    if (solReceived < 0n)
+        return null;
+    const capped = solReceived < amm.realSolReserves ? solReceived : amm.realSolReserves;
+    if (capped === 0n)
+        return null;
+    return capped;
+}
+export function applySell(amm, tokenAmount) {
+    if (tokenAmount === 0n || amm.realSolReserves === 0n)
+        return null;
+    const k = amm.virtualSolReserves * amm.virtualTokenReserves;
+    const newVToken = amm.virtualTokenReserves + tokenAmount;
+    const newVSol = k / newVToken;
+    const uncappedSol = amm.virtualSolReserves - newVSol;
+    if (uncappedSol < 0n)
+        return null;
+    const solAmount = uncappedSol < amm.realSolReserves ? uncappedSol : amm.realSolReserves;
+    if (solAmount === 0n)
+        return null;
+    return {
+        result: { tokenAmount, solAmount },
+        reserves: {
+            virtualSolReserves: newVSol,
+            virtualTokenReserves: newVToken,
+            realSolReserves: amm.realSolReserves - solAmount,
+            realTokenReserves: amm.realTokenReserves + tokenAmount,
+            initialVirtualTokenReserves: amm.initialVirtualTokenReserves,
+        },
+    };
+}
+// ======================== src/quote.ts ========================
+/**
+ * Quote / preview engine (pure). Mirrors on-chain fee handling:
+ *  buy  (buy.rs):  fee = solPayWithFee * 1%; AMM applied to (solPayWithFee - fee).
+ *  sell (sell.rs): solOut = curve output; fee = solOut * 1%; user gets (solOut - fee).
+ */
+export const FEE_RATE_BPS = 100n; // 1%
+export const BASIS_POINTS = 10000n;
+const feeOf = (amount) => (amount * FEE_RATE_BPS) / BASIS_POINTS;
+export function previewBuy(reserves, solPayWithFee) {
+    if (solPayWithFee <= 0n)
+        return null;
+    const fee = feeOf(solPayWithFee);
+    const solIntoCurve = solPayWithFee - fee;
+    const applied = applyBuy(reserves, solIntoCurve);
+    if (!applied)
+        return null;
+    return { solPayWithFee, fee, solIntoCurve, tokensOut: applied.result.tokenAmount, reservesAfter: applied.reserves };
+}
+export function previewSell(reserves, tokensIn) {
+    if (tokensIn <= 0n)
+        return null;
+    const applied = applySell(reserves, tokensIn);
+    if (!applied)
+        return null;
+    const solOutGross = applied.result.solAmount;
+    const fee = feeOf(solOutGross);
+    return { tokensIn, solOutGross, fee, netSolToUser: solOutGross - fee, reservesAfter: applied.reserves };
+}
+// ======================== src/decode.ts ========================
+/**
+ * Dependency-free decoders for eva account bytes (works for L1 OR ER reads).
+ * Layouts from eva-contract/programs/program/src/state.rs (Anchor = 8-byte
+ * discriminator + Borsh fields). SPL token amount @ offset 64.
+ */
+// ---- Trench (state.rs struct Trench) ----
+export const TRENCH_OFFSETS = {
+    id: 8, creator: 16, authority: 48, status: 80, totalDepositedSol: 81,
+    virtualSolReserves: 89, virtualTokenReserves: 105, realSolReserves: 121,
+    realTokenReserves: 137, initialVirtualTokenReserves: 153,
+    biddingStartBlock: 169, biddingEndBlock: 177, tradingEndBlock: 185,
+    tokenMint: 193, startTime: 225, prizePoolReserves: 233, bump: 241,
+};
+export const TRENCH_LEN = 242;
+function uLE(data, off, len) {
+    let v = 0n;
+    for (let i = 0; i < len; i++)
+        v |= BigInt(data[off + i]) << (8n * BigInt(i));
+    return v;
+}
+function iLE(data, off, len) {
+    const u = uLE(data, off, len);
+    const bits = BigInt(len) * 8n;
+    return u >= 1n << (bits - 1n) ? u - (1n << bits) : u;
+}
+const STATUS = ["Bidding", "Trading", "Ended"];
+export function decodeTrenchReserves(data) {
+    if (data.length < TRENCH_LEN)
+        throw new Error(`Trench data too short: ${data.length} < ${TRENCH_LEN}`);
+    return {
+        virtualSolReserves: uLE(data, TRENCH_OFFSETS.virtualSolReserves, 16),
+        virtualTokenReserves: uLE(data, TRENCH_OFFSETS.virtualTokenReserves, 16),
+        realSolReserves: uLE(data, TRENCH_OFFSETS.realSolReserves, 16),
+        realTokenReserves: uLE(data, TRENCH_OFFSETS.realTokenReserves, 16),
+        initialVirtualTokenReserves: uLE(data, TRENCH_OFFSETS.initialVirtualTokenReserves, 16),
+    };
+}
+export function decodeTrench(data) {
+    if (data.length < TRENCH_LEN)
+        throw new Error(`Trench data too short: ${data.length} < ${TRENCH_LEN}`);
+    return {
+        id: uLE(data, TRENCH_OFFSETS.id, 8),
+        status: STATUS[data[TRENCH_OFFSETS.status]] ?? "Unknown",
+        totalDepositedSol: uLE(data, TRENCH_OFFSETS.totalDepositedSol, 8),
+        reserves: decodeTrenchReserves(data),
+        biddingStartBlock: uLE(data, TRENCH_OFFSETS.biddingStartBlock, 8),
+        biddingEndBlock: uLE(data, TRENCH_OFFSETS.biddingEndBlock, 8),
+        tradingEndBlock: uLE(data, TRENCH_OFFSETS.tradingEndBlock, 8),
+        tokenMint: data.slice(TRENCH_OFFSETS.tokenMint, TRENCH_OFFSETS.tokenMint + 32),
+        startTime: iLE(data, TRENCH_OFFSETS.startTime, 8),
+        prizePoolReserves: uLE(data, TRENCH_OFFSETS.prizePoolReserves, 8),
+        bump: data[TRENCH_OFFSETS.bump],
+    };
+}
+export function decodeGlobalState(data) {
+    if (data.length < 88)
+        throw new Error(`GlobalState data too short: ${data.length} < 88`);
+    return {
+        admin: data.slice(8, 40),
+        feeRecipient: data.slice(40, 72),
+        totalTrenches: uLE(data, 72, 8),
+        biddingDuration: uLE(data, 80, 8),
+        tradingDuration: data.length >= 96 ? uLE(data, 88, 8) : 0n,
+    };
+}
+// ---- SPL token account amount (u64 @ 64) ----
+export function decodeTokenAmount(data) {
+    if (data.length < 72)
+        throw new Error(`token account data too short: ${data.length} < 72`);
+    return uLE(data, 64, 8);
+}
+// ======================== src/config.ts ========================
+/**
+ * Network presets + resolved config. Works for localnet now and devnet later —
+ * the only difference is the endpoints + (possibly) program ids you pass in.
+ *
+ * IMPORTANT (devnet): public Solana devnet has NO NorthStar ER/Portal. "devnet"
+ * here means a NorthStar validator running in a devnet-style deployment — you MUST
+ * point l1Rpc/erRpc at THAT node's endpoints. There is no hosted default yet.
+ */
+export const DEFAULT_PORTAL_PROGRAM_ID = "5TeWSsjg2gbxCyWVniXeCmwM7UtHTCK7svzJr5xYJzHf";
+export const DEFAULT_EVA_PROGRAM_ID = "CQru6EauVg2UwepFCvY5qWuqCPEWYC4ta43wBbkFYtmo";
+export const INITIAL_TOKEN_SUPPLY = 1000000000n * 1000000n; // 1B @ 6 decimals
+export const TOKEN_DECIMALS = 6;
+export const NETWORKS = {
+    localnet: {
+        l1Rpc: "http://127.0.0.1:8899",
+        erRpc: "http://127.0.0.1:8910",
+        erWs: "ws://127.0.0.1:8911",
+        portalProgramId: DEFAULT_PORTAL_PROGRAM_ID,
+        evaProgramId: DEFAULT_EVA_PROGRAM_ID,
+    },
+    devnet: {
+        // No public NorthStar devnet endpoint exists yet — override l1Rpc/erRpc with
+        // your NorthStar devnet node's URLs. These sentinels fail fast if you forget.
+        l1Rpc: "",
+        erRpc: "",
+        erWs: "",
+        portalProgramId: DEFAULT_PORTAL_PROGRAM_ID,
+        evaProgramId: DEFAULT_EVA_PROGRAM_ID,
+    },
+};
+const pk = (v) => (typeof v === "string" ? new PublicKey(v) : v);
+const bn = (v, d) => (v === undefined ? d : BigInt(v));
+export function resolveConfig(input) {
+    const preset = NETWORKS[input.network ?? "localnet"];
+    const l1Rpc = input.l1Rpc ?? preset.l1Rpc;
+    const erRpc = input.erRpc ?? preset.erRpc;
+    if (!l1Rpc || !erRpc) {
+        throw new Error(`Missing RPC endpoints for network "${input.network}". For devnet, pass l1Rpc + erRpc ` +
+            `pointing at your NorthStar node (public Solana devnet has no ER/Portal).`);
+    }
+    return {
+        l1Rpc,
+        erRpc,
+        erWs: input.erWs ?? preset.erWs,
+        portalProgramId: pk(input.portalProgramId ?? preset.portalProgramId),
+        evaProgramId: pk(input.evaProgramId ?? preset.evaProgramId),
+        gridId: bn(input.gridId, 1n),
+        ttlSlots: bn(input.ttlSlots, 1000000n),
+        feeCap: bn(input.feeCap, 1000000000n),
+        settlementIntervalSlots: bn(input.settlementIntervalSlots, 50n),
+    };
+}
+// ======================== src/portal.ts ========================
+/**
+ * NorthStar Portal program client — CORRECTED encoders + account layouts that
+ * match the deployed program (northstar/.../programs/portal). These differ from
+ * the published @sonicsvm/northstar-sdk (see ../README + LIMITATIONS):
+ *  - OpenSession data includes `validator` + `settlement_interval_slots`.
+ *  - Delegate uses the multi-delegation layout: [payer, system_program, session,
+ *    (delegated_account, owner_program, delegation_record, buffer)…] — session @ index 2.
+ *  - Undelegate keeps the legacy order.
+ */
+// Portal instruction enum tags (first byte of instruction data). WithdrawFee was
+// removed upstream; tail variants renumbered. We only use 0–4.
+const TAG = {
+    OpenSession: 0, CloseSession: 1, DepositFee: 2, Delegate: 3, Undelegate: 4,
+};
+const SEED = {
+    session: "session", feeVault: "fee_vault", delegation: "delegation",
+    depositReceipt: "deposit_receipt", withdrawalSink: "withdrawal_sink",
+};
+class W {
+    b = [];
+    u8(v) { this.b.push(v & 0xff); return this; }
+    u64(v) { let x = BigInt(v); for (let i = 0; i < 8; i++) {
+        this.b.push(Number(x & 0xffn));
+        x >>= 8n;
+    } return this; }
+    bytes32(x) { if (x.length !== 32)
+        throw new Error(`expected 32 bytes, got ${x.length}`); for (const v of x)
+        this.b.push(v); return this; }
+    out() { return Uint8Array.from(this.b); }
+}
+export const encodeOpenSession = (a) => new W().u8(TAG.OpenSession).u64(a.gridId).u64(a.ttlSlots).u64(a.feeCap).bytes32(a.validator).u64(a.settlementIntervalSlots).out();
+export const encodeCloseSession = () => new W().u8(TAG.CloseSession).out();
+export const encodeDepositFee = (lamports) => new W().u8(TAG.DepositFee).u64(lamports).out();
+export const encodeDelegate = (gridId) => new W().u8(TAG.Delegate).u64(gridId).out();
+export const encodeUndelegate = () => new W().u8(TAG.Undelegate).out();
+// ---- PDAs ----
+export const sessionPda = (programId) => PublicKey.findProgramAddressSync([Buffer.from(SEED.session)], programId)[0];
+export const feeVaultPda = (programId) => PublicKey.findProgramAddressSync([Buffer.from(SEED.feeVault)], programId)[0];
+export const delegationRecordPda = (programId, delegated) => PublicKey.findProgramAddressSync([Buffer.from(SEED.delegation), delegated.toBuffer()], programId)[0];
+export const depositReceiptPda = (programId, session, recipient) => PublicKey.findProgramAddressSync([Buffer.from(SEED.depositReceipt), session.toBuffer(), recipient.toBuffer()], programId)[0];
+export const withdrawalSinkPda = (programId, session, recipient) => PublicKey.findProgramAddressSync([Buffer.from(SEED.withdrawalSink), session.toBuffer(), recipient.toBuffer()], programId)[0];
+const SYS = SystemProgram.programId;
+// ---- instruction builders ----
+export function openSessionIx(p) {
+    return new TransactionInstruction({
+        programId: p.programId,
+        keys: [
+            { pubkey: p.payer, isSigner: true, isWritable: true },
+            { pubkey: sessionPda(p.programId), isSigner: false, isWritable: true },
+            { pubkey: feeVaultPda(p.programId), isSigner: false, isWritable: true },
+            { pubkey: SYS, isSigner: false, isWritable: false },
+        ],
+        data: Buffer.from(encodeOpenSession({ gridId: p.gridId, ttlSlots: p.ttlSlots, feeCap: p.feeCap, validator: p.validator.toBytes(), settlementIntervalSlots: p.settlementIntervalSlots })),
+    });
+}
+export function closeSessionIx(p) {
+    return new TransactionInstruction({
+        programId: p.programId,
+        keys: [
+            { pubkey: p.closer, isSigner: true, isWritable: true },
+            { pubkey: sessionPda(p.programId), isSigner: false, isWritable: true },
+            { pubkey: feeVaultPda(p.programId), isSigner: false, isWritable: true },
+            { pubkey: SYS, isSigner: false, isWritable: false },
+        ],
+        data: Buffer.from(encodeCloseSession()),
+    });
+}
+export function depositFeeIx(p) {
+    const session = sessionPda(p.programId);
+    return new TransactionInstruction({
+        programId: p.programId,
+        keys: [
+            { pubkey: p.depositor, isSigner: true, isWritable: true },
+            { pubkey: session, isSigner: false, isWritable: false },
+            { pubkey: depositReceiptPda(p.programId, session, p.recipient), isSigner: false, isWritable: true },
+            { pubkey: p.recipient, isSigner: false, isWritable: false },
+            { pubkey: SYS, isSigner: false, isWritable: false },
+        ],
+        data: Buffer.from(encodeDepositFee(p.lamports)),
+    });
+}
+/** Multi-delegation layout: prefix [payer, system_program, session] + one group. */
+export function delegateIx(p) {
+    return new TransactionInstruction({
+        programId: p.programId,
+        keys: [
+            { pubkey: p.payer, isSigner: true, isWritable: true },
+            { pubkey: SYS, isSigner: false, isWritable: false },
+            { pubkey: sessionPda(p.programId), isSigner: false, isWritable: false },
+            { pubkey: p.delegatedAccount, isSigner: true, isWritable: true },
+            { pubkey: p.ownerProgram, isSigner: false, isWritable: false },
+            { pubkey: delegationRecordPda(p.programId, p.delegatedAccount), isSigner: false, isWritable: true },
+            { pubkey: p.buffer, isSigner: false, isWritable: false },
+        ],
+        data: Buffer.from(encodeDelegate(p.gridId)),
+    });
+}
+/** Legacy order (undelegate was not refactored). */
+export function undelegateIx(p) {
+    return new TransactionInstruction({
+        programId: p.programId,
+        keys: [
+            { pubkey: p.authority, isSigner: true, isWritable: true },
+            { pubkey: p.delegatedAccount, isSigner: false, isWritable: true },
+            { pubkey: p.ownerProgram, isSigner: false, isWritable: false },
+            { pubkey: delegationRecordPda(p.programId, p.delegatedAccount), isSigner: false, isWritable: true },
+            { pubkey: SYS, isSigner: false, isWritable: false },
+            { pubkey: sessionPda(p.programId), isSigner: false, isWritable: false },
+        ],
+        data: Buffer.from(encodeUndelegate()),
+    });
+}
+// namespace shim so client code can call portal.*
+const portal = { encodeOpenSession, encodeCloseSession, encodeDepositFee, encodeDelegate, encodeUndelegate, sessionPda, feeVaultPda, delegationRecordPda, depositReceiptPda, withdrawalSinkPda, openSessionIx, closeSessionIx, depositFeeIx, delegateIx, undelegateIx };
+// ======================== src/evaPdas.ts ========================
+/** eva-contract PDA + ATA derivations (mirrors eva-contract/sdk.ts + create_trench.rs). */
+const u64le = (n) => { const b = Buffer.alloc(8); b.writeBigUInt64LE(n); return b; };
+export const globalStatePda = (programId) => PublicKey.findProgramAddressSync([Buffer.from("global")], programId)[0];
+export const trenchPda = (programId, id) => PublicKey.findProgramAddressSync([Buffer.from("trench"), u64le(id)], programId)[0];
+export const agentPda = (programId, trench, user) => PublicKey.findProgramAddressSync([Buffer.from("agent"), trench.toBuffer(), user.toBuffer()], programId)[0];
+export const tokenMintPda = (programId, trench) => PublicKey.findProgramAddressSync([Buffer.from("mint"), trench.toBuffer()], programId)[0];
+export const trenchTokenVault = (mint, trench) => getAssociatedTokenAddressSync(mint, trench, true);
+export const userTokenAccount = (mint, user) => getAssociatedTokenAddressSync(mint, user);
+// namespace shim so client code can call evaPdas.*
+const evaPdas = { globalStatePda, trenchPda, agentPda, tokenMintPda, trenchTokenVault, userTokenAccount };
+// ======================== src/client.ts ========================
+/**
+ * NorthstarEva — the team-facing SDK class.
+ *
+ * Encapsulates everything needed to run the eva program on a NorthStar ephemeral
+ * rollup and cut fees: lane routing (control/custody → L1, hot-path eva → ER),
+ * the corrected Portal encoders, dev-mode execution, `processed`-commitment reads
+ * (so read-after-write is fresh), and transient-error retries.
+ *
+ * Works for localnet and devnet — only the endpoints/program-ids change (config).
+ */
+// @coral-xyz/anchor is CommonJS — runtime values live on the default export.
+const A = anchor.default ?? anchor;
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+function loadBundledIdl() {
+    return __EVA_IDL__;
+}
+export class NorthstarEva {
+    cfg;
+    l1;
+    er;
+    wallet;
+    validatorIdentity;
+    program; // eva, bound to the ER connection
+    pollMs;
+    constructor(opts) {
+        this.cfg = resolveConfig(opts);
+        this.wallet = opts.wallet;
+        this.validatorIdentity = opts.validatorIdentity
+            ? (typeof opts.validatorIdentity === "string" ? new PublicKey(opts.validatorIdentity) : opts.validatorIdentity)
+            : opts.wallet.publicKey;
+        this.pollMs = opts.pollIntervalMs ?? 500;
+        this.l1 = new Connection(this.cfg.l1Rpc, "confirmed");
+        // ER provider reads at "processed" so account resolution / reads are fresh.
+        this.er = new Connection(this.cfg.erRpc, "processed");
+        const idl = opts.evaIdl ?? (opts.evaIdlPath ? JSON.parse(readFileSync(opts.evaIdlPath, "utf8")) : loadBundledIdl());
+        idl.address = this.cfg.evaProgramId.toBase58(); // honor config / devnet override
+        const provider = new A.AnchorProvider(this.er, new A.Wallet(this.wallet), { commitment: "processed" });
+        this.program = new A.Program(idl, provider);
+    }
+    static create(opts) { return new NorthstarEva(opts); }
+    // ───────────────────────── ER transport (raw RPC, retries, processed) ─────────────────────────
+    async erRpc(method, params = []) {
+        let lastErr;
+        for (let attempt = 0; attempt < 3; attempt++) {
+            try {
+                const res = await fetch(this.cfg.erRpc, {
+                    method: "POST", headers: { "content-type": "application/json" },
+                    body: JSON.stringify({ jsonrpc: "2.0", id: 1, method, params }),
+                });
+                const json = (await res.json());
+                if (json.error)
+                    throw new Error(`${method}: ${JSON.stringify(json.error)}`);
+                return json.result;
+            }
+            catch (e) {
+                lastErr = e;
+                const msg = String(e?.message ?? e);
+                if (msg.startsWith(`${method}:`) || attempt === 2)
+                    throw e;
+                await sleep(this.pollMs);
+            }
+        }
+        throw lastErr;
+    }
+    /** Read an account from the ER at `processed` (fresh) — null on not-found. */
+    async erGetAccount(address) {
+        const r = await this.erRpc("getAccountInfo", [address.toBase58(), { encoding: "base64", commitment: "processed" }]);
+        const v = r?.value;
+        return v ? { data: Uint8Array.from(Buffer.from(v.data[0], "base64")), lamports: BigInt(v.lamports), owner: v.owner } : null;
+    }
+    async l1GetAccount(address) {
+        const info = await this.l1.getAccountInfo(address, "confirmed");
+        return info ? { data: new Uint8Array(info.data), lamports: BigInt(info.lamports), owner: info.owner.toBase58() } : null;
+    }
+    async erBalance(address) {
+        const r = await this.erRpc("getBalance", [address.toBase58(), { commitment: "processed" }]);
+        return BigInt(r.value);
+    }
+    // ───────────────────────── health / session reads ─────────────────────────
+    async health() {
+        let l1 = false, er = false;
+        try {
+            await this.l1.getSlot();
+            l1 = true;
+        }
+        catch { /* */ }
+        try {
+            er = (await this.erRpc("getHealth")) === "ok";
+        }
+        catch { /* */ }
+        return { l1, er };
+    }
+    syncStatus() { return this.erRpc("northstarSysGetSyncStatus"); }
+    getSessionPdaFromEr() { return this.erRpc("getSessionPda"); }
+    getDelegatedAccounts() { return this.erRpc("getDelegatedAccounts"); }
+    sessionPda() { return portal.sessionPda(this.cfg.portalProgramId); }
+    // ───────────────────────── L1 send + ER send ─────────────────────────
+    async sendOnL1(instructions, signers) {
+        const tx = new Transaction().add(...instructions);
+        return sendAndConfirmTransaction(this.l1, tx, signers, { commitment: "confirmed", skipPreflight: false });
+    }
+    /** Send a tx to the ER and confirm by polling (the ER returns Ok on acceptance). */
+    async sendOnEr(instructions, signers) {
+        let signature = "", lastErr;
+        for (let attempt = 0; attempt < 3; attempt++) {
+            try {
+                const { blockhash } = await this.er.getLatestBlockhash("processed");
+                const tx = new Transaction({ feePayer: signers[0].publicKey, blockhash, lastValidBlockHeight: 0 });
+                tx.add(...instructions);
+                tx.sign(...signers);
+                signature = await this.er.sendRawTransaction(tx.serialize(), { skipPreflight: false, preflightCommitment: "processed" });
+                break;
+            }
+            catch (e) {
+                lastErr = e;
+                const msg = String(e?.message ?? e);
+                if (!/fetch failed|socket|UND_ERR|ECONNRESET|other side closed|terminated|network/i.test(msg) || attempt === 2)
+                    throw e;
+                await sleep(800);
+            }
+        }
+        if (!signature)
+            throw lastErr;
+        let err = null, confirmed = false;
+        for (let i = 0; i < 40; i++) {
+            const r = await this.erRpc("getSignatureStatuses", [[signature], { searchTransactionHistory: true }]);
+            const st = r?.value?.[0];
+            if (st) {
+                err = st.err ?? null;
+                if (st.err || st.confirmationStatus) {
+                    confirmed = !st.err;
+                    break;
+                }
+            }
+            await sleep(this.pollMs);
+        }
+        return { signature, err, confirmed };
+    }
+    async sendEva(ix, label) {
+        const res = await this.sendOnEr([ix], [this.wallet]);
+        if (res.err)
+            throw new Error(`${label} failed on ER: ${JSON.stringify(res.err)}`);
+        if (!res.confirmed) {
+            throw new Error(`${label}: ER tx not confirmed within the poll budget (sig ${res.signature}). It may have been silently dropped — check validator logs.`);
+        }
+        return res.signature;
+    }
+    /** Fetch eva GlobalState from the ER or throw a clear "not initialized" error. */
+    async requireGlobal() {
+        const g = await this.getGlobal("er");
+        if (!g)
+            throw new Error("eva global state not initialized on the ER — call initialize() first");
+        return g;
+    }
+    get methods() { return this.program.methods; }
+    bn(v) { return new A.BN(v.toString()); }
+    // ───────────────────────── Portal control (L1) ─────────────────────────
+    async openSession() {
+        const pda = this.sessionPda();
+        if (await this.l1GetAccount(pda))
+            return { signature: null, sessionPda: pda, alreadyOpen: true };
+        const ix = portal.openSessionIx({
+            programId: this.cfg.portalProgramId, payer: this.wallet.publicKey,
+            gridId: this.cfg.gridId, ttlSlots: this.cfg.ttlSlots, feeCap: this.cfg.feeCap,
+            validator: this.validatorIdentity, settlementIntervalSlots: this.cfg.settlementIntervalSlots,
+        });
+        const signature = await this.sendOnL1([ix], [this.wallet]);
+        return { signature, sessionPda: pda, alreadyOpen: false };
+    }
+    async closeSession() {
+        return this.sendOnL1([portal.closeSessionIx({ programId: this.cfg.portalProgramId, closer: this.wallet.publicKey })], [this.wallet]);
+    }
+    depositReceiptPda(recipient = this.wallet.publicKey) {
+        return portal.depositReceiptPda(this.cfg.portalProgramId, this.sessionPda(), recipient);
+    }
+    /** DepositFee on L1 — funds an ER fee payer (its ER balance = these credits). */
+    async fundErFeePayer(lamports, recipient = this.wallet.publicKey) {
+        return this.sendOnL1([portal.depositFeeIx({ programId: this.cfg.portalProgramId, depositor: this.wallet.publicKey, recipient, lamports })], [this.wallet]);
+    }
+    /** Ensure the ER fee payer has >= `lamports`; tops up via DepositFee + waits for the credit. */
+    async ensureErFunds(lamports, recipient = this.wallet.publicKey) {
+        let bal = await this.erBalance(recipient).catch(() => 0n);
+        if (bal >= lamports)
+            return bal;
+        await this.fundErFeePayer(lamports, recipient);
+        for (let i = 0; i < 25; i++) {
+            await sleep(800);
+            bal = await this.erBalance(recipient).catch(() => 0n);
+            if (bal >= lamports)
+                break;
+        }
+        return bal;
+    }
+    /** Delegate a plain keypair account (System-owned) into the ER (the "proper" path). */
+    async delegateKeypairAccount(target) {
+        const buffer = Keypair.generate();
+        const rent = await this.l1.getMinimumBalanceForRentExemption(0);
+        const createBuffer = SystemProgram.createAccount({ fromPubkey: this.wallet.publicKey, newAccountPubkey: buffer.publicKey, lamports: rent, space: 0, programId: SystemProgram.programId });
+        const ix = portal.delegateIx({ programId: this.cfg.portalProgramId, payer: this.wallet.publicKey, delegatedAccount: target.publicKey, ownerProgram: SystemProgram.programId, buffer: buffer.publicKey, gridId: this.cfg.gridId });
+        return this.sendOnL1([createBuffer, ix], [this.wallet, target, buffer]);
+    }
+    /** Create a fresh Portal-owned account on L1 (delegation target helper). */
+    async createPortalOwnedAccount(space = 0) {
+        const acct = Keypair.generate();
+        const rent = await this.l1.getMinimumBalanceForRentExemption(space);
+        const ix = SystemProgram.createAccount({ fromPubkey: this.wallet.publicKey, newAccountPubkey: acct.publicKey, lamports: rent + 10_000, space, programId: this.cfg.portalProgramId });
+        await this.sendOnL1([ix], [this.wallet, acct]);
+        return acct;
+    }
+    // ───────────────────────── eva PDAs ─────────────────────────
+    globalStatePda() { return evaPdas.globalStatePda(this.cfg.evaProgramId); }
+    trenchPda(id) { return evaPdas.trenchPda(this.cfg.evaProgramId, id); }
+    tokenMintPda(id) { return evaPdas.tokenMintPda(this.cfg.evaProgramId, this.trenchPda(id)); }
+    trenchVault(id) { return evaPdas.trenchTokenVault(this.tokenMintPda(id), this.trenchPda(id)); }
+    userAta(id, user = this.wallet.publicKey) { return evaPdas.userTokenAccount(this.tokenMintPda(id), user); }
+    // ───────────────────────── eva reads (processed by default) ─────────────────────────
+    async getGlobal(source = "er") {
+        const info = source === "er" ? await this.erGetAccount(this.globalStatePda()) : await this.l1GetAccount(this.globalStatePda());
+        return info ? decodeGlobalState(info.data) : null;
+    }
+    async getTrench(id, source = "er", retries = 1) {
+        const pda = this.trenchPda(id);
+        for (let i = 0; i < retries; i++) {
+            const info = source === "er" ? await this.erGetAccount(pda) : await this.l1GetAccount(pda);
+            if (info?.data?.length)
+                return decodeTrench(info.data);
+            if (i < retries - 1)
+                await sleep(this.pollMs);
+        }
+        return null;
+    }
+    async getUserTokenBalance(id, user = this.wallet.publicKey, source = "er") {
+        const ata = this.userAta(id, user);
+        const info = source === "er" ? await this.erGetAccount(ata) : await this.l1GetAccount(ata);
+        return info?.data?.length ? decodeTokenAmount(info.data) : 0n;
+    }
+    // pure quote helpers
+    previewBuy(reserves, solPayWithFee) { return previewBuy(reserves, solPayWithFee); }
+    previewSell(reserves, tokensIn) { return previewSell(reserves, tokensIn); }
+    decodeReserves(data) { return decodeTrenchReserves(data); }
+    // ───────────────────────── User Deposit & Withdraw SOL API ─────────────────────────
+    // (the "green box" — fund L1→ER, query balance, withdraw ER→L1)
+    /** Query an account's SOL balance on BOTH lanes (lamports). No program call, no fee. */
+    async querySolBalance(account = this.wallet.publicKey) {
+        const er = await this.erBalance(account).catch(() => 0n);
+        const l1 = (await this.l1GetAccount(account))?.lamports ?? 0n;
+        return { er, l1 };
+    }
+    /** "Fund fee to ER payer" — deposit SOL from L1 so `recipient` is credited & spendable on the ER. Alias of fundErFeePayer. */
+    async fundFeeToErPayer(lamports, recipient = this.wallet.publicKey) {
+        return this.fundErFeePayer(lamports, recipient);
+    }
+    /** The ER WithdrawalSink PDA for a recipient (where ER withdrawal requests are sent). */
+    getWithdrawalSink(recipient = this.wallet.publicKey) {
+        return portal.withdrawalSinkPda(this.cfg.portalProgramId, this.sessionPda(), recipient);
+    }
+    /**
+     * "Withdraw fee from ER" (path 2): an ER `system_transfer` from `recipient` → its
+     * WithdrawalSink. The validator pays the L1 SOL ASYNCHRONOUSLY at the next settlement
+     * (use {@link waitForL1Settlement} to await it). `recipient` is a Keypair (it signs the
+     * ER transfer; the L1 receiver never signs).
+     *
+     * NOTE: the L1 payout currently goes to the SAME account that deposited — an arbitrary
+     * `toL1` destination is not supported by the Portal program yet (pending protocol change).
+     */
+    async requestWithdraw(p) {
+        if (p.toL1 && !p.toL1.equals(p.recipient.publicKey)) {
+            throw new Error("Arbitrary L1 withdrawal destination is not supported yet (Portal pays the deposit recipient). Omit `toL1` or set it equal to recipient.");
+        }
+        const sink = this.getWithdrawalSink(p.recipient.publicKey);
+        const ix = SystemProgram.transfer({ fromPubkey: p.recipient.publicKey, toPubkey: sink, lamports: Number(p.lamports) });
+        return this.sendOnEr([ix], [p.recipient]);
+    }
+    /** Poll an account's L1 balance until it rises by >= `expectedDelta` (settlement is async). Returns the final L1 balance. */
+    async waitForL1Settlement(account, expectedDelta, timeoutMs = 60_000) {
+        const start = (await this.l1GetAccount(account))?.lamports ?? 0n;
+        const attempts = Math.max(1, Math.ceil(timeoutMs / 1000));
+        let cur = start;
+        for (let i = 0; i < attempts; i++) {
+            await sleep(1000);
+            cur = (await this.l1GetAccount(account))?.lamports ?? 0n;
+            if (cur - start >= expectedDelta)
+                break;
+        }
+        return cur;
+    }
+    // ───────────────────────── eva game (executed on the ER, dev-mode) ─────────────────────────
+    async initialize(p) {
+        if (await this.getGlobal("er"))
+            return null; // already initialized
+        const ix = await this.methods.initialize(this.bn(p.biddingDuration), this.bn(p.tradingDuration))
+            .accounts({ admin: this.wallet.publicKey }).instruction();
+        return this.sendEva(ix, "initialize");
+    }
+    /** createTrench with the next sequential id (id == total_trenches + 1). */
+    async createTrench(p = {}) {
+        const g = await this.getGlobal("er");
+        if (!g)
+            throw new Error("global state not initialized — call initialize() first");
+        const trenchId = g.totalTrenches + 1n;
+        const ivtr = p.initialVirtualTokenReserves ?? INITIAL_TOKEN_SUPPLY / 2n;
+        const ix = await this.methods.createTrench(this.bn(trenchId), this.bn(ivtr))
+            .accounts({ globalState: this.globalStatePda(), creator: this.wallet.publicKey }).instruction();
+        const signature = await this.sendEva(ix, "createTrench");
+        return { trenchId, signature };
+    }
+    async deposit(p) {
+        const ix = await this.methods.deposit(this.bn(p.lamports), this.bn(p.thinkId ?? 0n))
+            .accounts({ trench: this.trenchPda(p.trenchId), user: this.wallet.publicKey }).instruction();
+        return this.sendEva(ix, "deposit");
+    }
+    /** finalize — waits for the ER slot to pass biddingEndBlock, then seeds the AMM. */
+    async finalize(p) {
+        const g = await this.requireGlobal();
+        const t = await this.getTrench(p.trenchId, "er", 10);
+        if (t)
+            for (let i = 0; i < 80; i++) {
+                const s = BigInt(await this.erRpc("getSlot"));
+                if (s >= t.biddingEndBlock)
+                    break;
+                await sleep(this.pollMs);
+            }
+        const ix = await this.methods.finalize()
+            .accounts({ trench: this.trenchPda(p.trenchId), globalState: this.globalStatePda(), feeRecipient: new PublicKey(g.feeRecipient), admin: this.wallet.publicKey }).instruction();
+        return this.sendEva(ix, "finalize");
+    }
+    /** Create the user's token ATA on the ER (buy/sell require it to pre-exist). */
+    async ensureUserAta(p) {
+        const user = p.user ?? this.wallet.publicKey;
+        const ix = createAssociatedTokenAccountIdempotentInstruction(this.wallet.publicKey, this.userAta(p.trenchId, user), user, this.tokenMintPda(p.trenchId), TOKEN_PROGRAM_ID, ASSOCIATED_TOKEN_PROGRAM_ID);
+        return this.sendEva(ix, "ensureUserAta");
+    }
+    async buy(p) {
+        const g = await this.requireGlobal();
+        const ix = await this.methods.buy(this.bn(p.solPayWithFee), this.bn(p.thinkId ?? 0n))
+            .accounts({ trench: this.trenchPda(p.trenchId), globalState: this.globalStatePda(), feeRecipient: new PublicKey(g.feeRecipient), user: this.wallet.publicKey, trenchTokenVault: this.trenchVault(p.trenchId), userTokenAccount: this.userAta(p.trenchId), systemProgram: SystemProgram.programId, tokenProgram: TOKEN_PROGRAM_ID }).instruction();
+        const signature = await this.sendEva(ix, "buy");
+        return { signature, trench: (await this.getTrench(p.trenchId, "er", 5)), userTokens: await this.getUserTokenBalance(p.trenchId) };
+    }
+    async sell(p) {
+        const g = await this.requireGlobal();
+        const ix = await this.methods.sell(this.bn(p.tokenAmount), this.bn(p.minSolOutput ?? 0n), this.bn(p.thinkId ?? 0n))
+            .accounts({ trench: this.trenchPda(p.trenchId), globalState: this.globalStatePda(), feeRecipient: new PublicKey(g.feeRecipient), user: this.wallet.publicKey, trenchTokenVault: this.trenchVault(p.trenchId), userTokenAccount: this.userAta(p.trenchId), tokenProgram: TOKEN_PROGRAM_ID }).instruction();
+        const signature = await this.sendEva(ix, "sell");
+        return { signature, trench: (await this.getTrench(p.trenchId, "er", 5)), userTokens: await this.getUserTokenBalance(p.trenchId) };
+    }
+}