@augustdigital/sdk 8.14.0 → 8.16.0

package/lib/adapters/solana/constants.d.ts

@@ -15,11 +15,19 @@ declare const programIds: {
     "mainnet-beta": {
         vault: string;
     };
-    testnet: {
-        vault: string;
-    };
     localnet: {
         vault: string;
     };
 };
-export { fallbackDecimals, fallbackNetwork, fallbackRpcEndpoints, programIds, vaultIdl, };
+/** Solana networks the canonical august_vault program is actually deployed on. */
+type ISolanaDeployedNetwork = keyof typeof programIds;
+/**
+ * Program ids for `network`, or `undefined` when the canonical program has no
+ * deployment there (currently `testnet`). Callers must handle `undefined` —
+ * silently substituting a default would hand back a dead address.
+ */
+declare function getDeployedProgramIds(network: ISolanaNetwork): {
+    vault: string;
+} | undefined;
+export { fallbackDecimals, fallbackNetwork, fallbackRpcEndpoints, getDeployedProgramIds, programIds, vaultIdl, };
+export type { ISolanaDeployedNetwork };

package/lib/adapters/solana/constants.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.vaultIdl = exports.programIds = exports.fallbackRpcEndpoints = exports.fallbackNetwork = exports.fallbackDecimals = void 0;
+exports.getDeployedProgramIds = getDeployedProgramIds;
 const vault_idl_1 = require("./idl/vault-idl");
 Object.defineProperty(exports, "vaultIdl", { enumerable: true, get: function () { return vault_idl_1.vaultIdl; } });
 const fallbackDecimals = 8;
@@ -17,19 +18,35 @@ const fallbackRpcEndpoints = {
     localnet: 'http://127.0.0.1:8899',
 };
 exports.fallbackRpcEndpoints = fallbackRpcEndpoints;
+// The shared, canonical august_vault program (multi-vault), deployed under the
+// same id (`up12…`) on devnet and mainnet-beta. Per-vault program deploys (e.g.
+// the legacy SyrupBTC `7B8n…`, and the interim devnet `C8B1…`) are retired. At
+// runtime the program id is resolved from backend vault metadata; this map is
+// the default/fallback.
+//
+// Deliberately partial: no `testnet` entry — the program isn't deployed there,
+// and mapping it would hand callers a dead address that only fails deep inside a
+// transaction. Unmapped networks throw from `getProgram`/`getProgramId` instead.
+// `satisfies` keeps the literal ids in the generated docs while checking keys
+// against ISolanaNetwork, so `testnet` is absent from the type, not optional.
 const programIds = {
     devnet: {
-        vault: '7B8n9vL51b6ibqRAd1adZsi3x3kxtq5NZaondh22Vkyq',
+        vault: 'up12bytoZBmwofqsySf2uqKQ7zpfeKiAWwfvqzJjtRt',
     },
     ['mainnet-beta']: {
-        vault: '7B8n9vL51b6ibqRAd1adZsi3x3kxtq5NZaondh22Vkyq', // BTCsyrup vault
-    },
-    testnet: {
-        vault: '7B8n9vL51b6ibqRAd1adZsi3x3kxtq5NZaondh22Vkyq',
+        vault: 'up12bytoZBmwofqsySf2uqKQ7zpfeKiAWwfvqzJjtRt',
     },
     localnet: {
-        vault: '7B8n9vL51b6ibqRAd1adZsi3x3kxtq5NZaondh22Vkyq',
+        vault: 'up12bytoZBmwofqsySf2uqKQ7zpfeKiAWwfvqzJjtRt',
     },
 };
 exports.programIds = programIds;
+/**
+ * Program ids for `network`, or `undefined` when the canonical program has no
+ * deployment there (currently `testnet`). Callers must handle `undefined` —
+ * silently substituting a default would hand back a dead address.
+ */
+function getDeployedProgramIds(network) {
+    return programIds[network];
+}
 //# sourceMappingURL=constants.js.map

package/lib/adapters/solana/idl/vault-idl.d.ts

@@ -1,88 +1,73 @@
+/**
+ * august_vault program IDL (Anchor).
+ *
+ * GENERATED — do not edit by hand. The versioned multi-vault interface the SDK
+ * targets, generated from the devnet on-chain IDL of `C8B1…` — the only
+ * deployment that publishes one matching this file. Refresh with
+ * `anchor idl fetch C8B1… -u devnet`.
+ *
+ * At runtime the SDK targets the canonical `up12…` instead, whose own published
+ * IDL is STALE (an Anchor IDL upload is not refreshed by a program upgrade), so
+ * it can't be used as the generation source. The solana-idl-drift check (CI)
+ * therefore validates `up12…` by pinning its deployed binary and by decoding
+ * live VaultState accounts against this file — see
+ * tests/vaults/solana-idl-drift.test.ts.
+ *
+ * `address` is a build stamp (the mainnet id), NOT network-aware. Never rely on
+ * it: SolanaAdapter/getProgram resolve the real program id per network from
+ * programIds, or from an explicit `programId` override.
+ */
 export declare const vaultIdl: {
-    address: string;
-    metadata: {
+    accounts: {
+        discriminator: number[];
         name: string;
-        version: string;
-        spec: string;
-        description: string;
-    };
-    instructions: ({
+    }[];
+    address: string;
+    errors: {
+        code: number;
+        msg: string;
         name: string;
-        docs: string[];
+    }[];
+    events: {
         discriminator: number[];
-        accounts: ({
-            name: string;
-            writable: boolean;
-            pda: {
-                seeds: {
-                    kind: string;
-                    value: number[];
-                }[];
-            };
-            signer?: undefined;
-            address?: undefined;
-        } | {
-            name: string;
-            signer: boolean;
-            writable?: undefined;
-            pda?: undefined;
-            address?: undefined;
-        } | {
-            name: string;
-            writable: boolean;
-            pda?: undefined;
-            signer?: undefined;
-            address?: undefined;
-        } | {
-            name: string;
-            address: string;
-            writable?: undefined;
-            pda?: undefined;
-            signer?: undefined;
-        })[];
-        args: any[];
-    } | {
         name: string;
-        docs: string[];
-        discriminator: number[];
+    }[];
+    instructions: ({
         accounts: ({
             name: string;
-            writable: boolean;
             signer: boolean;
+            writable: boolean;
             docs?: undefined;
             pda?: undefined;
             address?: undefined;
         } | {
-            name: string;
             docs: string[];
-            writable: boolean;
+            name: string;
             signer: boolean;
+            writable: boolean;
             pda?: undefined;
             address?: undefined;
         } | {
-            name: string;
             docs: string[];
+            name: string;
             writable: boolean;
-            pda: {
-                seeds: {
-                    kind: string;
-                    value: number[];
-                }[];
-                program?: undefined;
-            };
             signer?: undefined;
+            pda?: undefined;
             address?: undefined;
         } | {
-            name: string;
             docs: string[];
-            writable: boolean;
+            name: string;
             signer?: undefined;
+            writable?: undefined;
             pda?: undefined;
             address?: undefined;
         } | {
             name: string;
-            writable: boolean;
             pda: {
+                program: {
+                    kind: string;
+                    value: number[];
+                };
                 seeds: ({
                     kind: string;
                     value: number[];
@@ -92,19 +77,16 @@ export declare const vaultIdl: {
                     path: string;
                     value?: undefined;
                 })[];
-                program: {
-                    kind: string;
-                    value: number[];
-                };
             };
+            writable: boolean;
             signer?: undefined;
             docs?: undefined;
             address?: undefined;
         } | {
-            name: string;
             address: string;
-            writable?: undefined;
+            name: string;
             signer?: undefined;
+            writable?: undefined;
             docs?: undefined;
             pda?: undefined;
         })[];
@@ -112,80 +94,75 @@ export declare const vaultIdl: {
             name: string;
             type: string;
         }[];
-    } | {
-        name: string;
-        docs: string[];
         discriminator: number[];
+        docs: string[];
+        name: string;
+    } | {
         accounts: ({
             name: string;
             writable: boolean;
-            pda: {
-                seeds: ({
-                    kind: string;
-                    value: number[];
-                    path?: undefined;
-                } | {
-                    kind: string;
-                    path: string;
-                    value?: undefined;
-                })[];
-            };
             signer?: undefined;
+            address?: undefined;
         } | {
             name: string;
-            writable: boolean;
-            pda?: undefined;
+            writable?: undefined;
             signer?: undefined;
+            address?: undefined;
         } | {
             name: string;
-            writable: boolean;
             signer: boolean;
-            pda?: undefined;
+            writable?: undefined;
+            address?: undefined;
         } | {
+            name: string;
+            signer: boolean;
+            writable: boolean;
+            address?: undefined;
+        } | {
+            address: string;
             name: string;
             writable?: undefined;
-            pda?: undefined;
             signer?: undefined;
         })[];
         args: {
             name: string;
             type: string;
         }[];
-    } | {
-        name: string;
-        docs: string[];
         discriminator: number[];
+        docs: string[];
+        name: string;
+    } | {
         accounts: ({
             name: string;
             writable: boolean;
+            pda?: undefined;
+            signer?: undefined;
+        } | {
+            name: string;
             pda: {
-                seeds: ({
+                program: {
                     kind: string;
                     value: number[];
-                    path?: undefined;
-                } | {
+                };
+                seeds: ({
                     kind: string;
                     path: string;
                     value?: undefined;
+                } | {
+                    kind: string;
+                    value: number[];
+                    path?: undefined;
                 })[];
             };
+            writable: boolean;
             signer?: undefined;
-            address?: undefined;
-        } | {
-            name: string;
-            writable?: undefined;
-            pda?: undefined;
-            signer?: undefined;
-            address?: undefined;
         } | {
             name: string;
-            writable: boolean;
             signer: boolean;
+            writable?: undefined;
             pda?: undefined;
-            address?: undefined;
         } | {
             name: string;
-            address: string;
             writable?: undefined;
             pda?: undefined;
             signer?: undefined;
@@ -194,52 +171,38 @@ export declare const vaultIdl: {
             name: string;
             type: string;
         }[];
-    } | {
-        name: string;
-        docs: string[];
         discriminator: number[];
+        docs: string[];
+        name: string;
+    } | {
         accounts: ({
-            name: string;
-            writable: boolean;
-            pda: {
-                seeds: {
-                    kind: string;
-                    value: number[];
-                }[];
-            };
-            signer?: undefined;
-            address?: undefined;
-        } | {
+            docs: string[];
             name: string;
             signer: boolean;
             writable?: undefined;
             pda?: undefined;
             address?: undefined;
         } | {
+            docs: string[];
             name: string;
             writable: boolean;
-            signer: boolean;
+            signer?: undefined;
             pda?: undefined;
             address?: undefined;
         } | {
+            docs: string[];
             name: string;
-            address: string;
+            signer?: undefined;
             writable?: undefined;
             pda?: undefined;
-            signer?: undefined;
-        })[];
-        args: {
-            name: string;
-            type: string;
-        }[];
-    } | {
-        name: string;
-        docs: string[];
-        discriminator: number[];
-        accounts: ({
+            address?: undefined;
+        } | {
             name: string;
-            writable: boolean;
             pda: {
+                program: {
+                    kind: string;
+                    value: number[];
+                };
                 seeds: ({
                     kind: string;
                     value: number[];
@@ -249,79 +212,49 @@ export declare const vaultIdl: {
                     path: string;
                     value?: undefined;
                 })[];
-                program?: undefined;
             };
-            signer?: undefined;
-        } | {
-            name: string;
             writable: boolean;
-            pda: {
-                seeds: ({
-                    kind: string;
-                    path: string;
-                    value?: undefined;
-                } | {
-                    kind: string;
-                    value: number[];
-                    path?: undefined;
-                })[];
-                program: {
-                    kind: string;
-                    value: number[];
-                };
-            };
+            docs?: undefined;
             signer?: undefined;
+            address?: undefined;
         } | {
+            address: string;
             name: string;
-            writable: boolean;
-            pda?: undefined;
+            docs?: undefined;
             signer?: undefined;
-        } | {
-            name: string;
-            signer: boolean;
             writable?: undefined;
             pda?: undefined;
-        } | {
-            name: string;
-            writable?: undefined;
-            pda?: undefined;
-            signer?: undefined;
         })[];
         args: {
             name: string;
             type: string;
         }[];
-    })[];
-    accounts: {
-        name: string;
         discriminator: number[];
-    }[];
-    events: {
+        docs: string[];
         name: string;
-        discriminator: number[];
-    }[];
-    errors: {
-        code: number;
+    })[];
+    metadata: {
+        description: string;
         name: string;
-        msg: string;
-    }[];
+        spec: string;
+        version: string;
+    };
     types: ({
         name: string;
-        serialization: string;
         repr: {
             kind: string;
         };
+        serialization: string;
         type: {
-            kind: string;
             fields: {
                 name: string;
                 type: string;
             }[];
+            kind: string;
         };
     } | {
         name: string;
         type: {
-            kind: string;
             fields: ({
                 name: string;
                 type: string;
@@ -331,8 +264,9 @@ export declare const vaultIdl: {
                     array: (string | number)[];
                 };
             })[];
+            kind: string;
         };
-        serialization?: undefined;
         repr?: undefined;
+        serialization?: undefined;
     })[];
 };