@openfort/openfort-node 0.9.3 → 0.10.0

package/examples/solana/policies/createSolAllowlistPolicy.ts

@@ -0,0 +1,27 @@
+// Usage: pnpm tsx solana/policies/createSolAllowlistPolicy.ts
+
+import Openfort from "@openfort/openfort-node";
+import "dotenv/config";
+
+const openfort = new Openfort(process.env.OPENFORT_API_KEY!, {
+  basePath: process.env.OPENFORT_BASE_URL,
+});
+
+const policy = await openfort.policies.create({
+  scope: "account",
+  description: "SOL Allowlist Policy",
+  rules: [
+    {
+      action: "accept",
+      operation: "signSolTransaction",
+      criteria: [
+        {
+          type: "solAddress",
+          addresses: ["DtdSSG8ZJRZVv5Jx7K1MeWp7Zxcu19GD5wQRGRpQ9uMF"],
+          operator: "in",
+        },
+      ],
+    },
+  ],
+});
+console.log("Created sol allowlist policy: ", policy.id);

package/examples/solana/policies/createSolMessagePolicy.ts

@@ -0,0 +1,29 @@
+// Usage: pnpm tsx solana/policies/createSolMessagePolicy.ts
+
+import Openfort from "@openfort/openfort-node";
+import "dotenv/config";
+
+const openfort = new Openfort(process.env.OPENFORT_API_KEY!, {
+  basePath: process.env.OPENFORT_BASE_URL,
+});
+
+// Create a policy that only allows signing messages starting with "Openfort:"
+const policy = await openfort.policies.create({
+  scope: "account",
+  description: "Allow messages with Openfort prefix only",
+  rules: [
+    {
+      action: "accept",
+      operation: "signSolMessage",
+      criteria: [
+        {
+          type: "solMessage",
+          operator: "match",
+          pattern: "^Openfort:.*",
+        },
+      ],
+    },
+  ],
+});
+
+console.log("Created sol message policy: ", policy.id);

package/examples/solana/policies/createSplTokenLimitsPolicy.ts

@@ -0,0 +1,33 @@
+// Usage: pnpm tsx solana/policies/createSplTokenLimitsPolicy.ts
+
+import Openfort from "@openfort/openfort-node";
+import "dotenv/config";
+
+const openfort = new Openfort(process.env.OPENFORT_API_KEY!, {
+  basePath: process.env.OPENFORT_BASE_URL,
+});
+
+// Create a policy that allows sending up to 1 USDC on Solana devnet
+const policy = await openfort.policies.create({
+  scope: "account",
+  description: "SPL Token Limits Policy",
+  rules: [
+    {
+      action: "accept",
+      operation: "sendSolTransaction",
+      criteria: [
+        {
+          type: "splValue",
+          value: "1000000",
+          operator: "<=",
+        },
+        {
+          type: "mintAddress",
+          addresses: ["4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU"],
+          operator: "in",
+        },
+      ],
+    },
+  ],
+});
+console.log("Created spl token limits policy: ", policy.id);

package/examples/solana/transactions/sendRawTransaction.ts

@@ -0,0 +1,23 @@
+// Usage: pnpm tsx solana/transactions/sendRawTransaction.ts
+
+import Openfort from "@openfort/openfort-node";
+import "dotenv/config";
+
+const openfort = new Openfort(process.env.OPENFORT_API_KEY!, {
+  basePath: process.env.OPENFORT_BASE_URL,
+  walletSecret: process.env.OPENFORT_WALLET_SECRET,
+  publishableKey: process.env.OPENFORT_PUBLISHABLE_KEY,
+});
+
+const account = await openfort.accounts.solana.backend.get({
+  address: "o24A5URLU3JNKg7AoeUrPsfsAo1NQeeAB4uQViAkpjq",
+});
+console.log("Solana account:", account.address);
+
+const base64Transaction = "AgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgAIAAgVNIUjL89213czrp82aA7pwQtVnJ433tRk70i1jD6x8RgvJ6NInwPBPRE1nsK0uFlw4un64nQPWoQ5z6rMgnEa401TyQ9UGEEZNtkD5WCpVzr4hzSQjxMXpK3bGAFWS+d8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMGRm/lIRcy/+ytunLDm+e8jOW7xfcSayxDmzpAAAAALajv1ShJYnJUlo8NjFHgtGjF+2MgsBy4LMtqcDvTyfUDBAAJA0BCDwAAAAAABAAFAkANAwADAgECDAIAAAAKAAAAAAAAAAA=";
+
+const result = await account.sendRawTransaction({
+  cluster: "devnet",
+  transaction: base64Transaction,
+});
+console.log("Transaction signature:", result.signature);

package/examples/solana/transactions/sendTransaction.ts

@@ -0,0 +1,37 @@
+// Usage: pnpm tsx solana/transactions/sendTransaction.ts
+//
+// Low-level example using raw instructions.
+// For simple transfers, see solana/transfer.ts instead.
+
+import Openfort from "@openfort/openfort-node";
+import { getTransferSolInstruction } from "@solana-program/system";
+import { address, createNoopSigner } from "@solana/kit";
+import "dotenv/config";
+
+const openfort = new Openfort(process.env.OPENFORT_API_KEY!, {
+  basePath: process.env.OPENFORT_BASE_URL,
+  walletSecret: process.env.OPENFORT_WALLET_SECRET,
+  publishableKey: process.env.OPENFORT_PUBLISHABLE_KEY,
+});
+
+const account = await openfort.accounts.solana.backend.get({
+  address: "o24A5URLU3JNKg7AoeUrPsfsAo1NQeeAB4uQViAkpjq",
+});
+console.log("Solana account:", account.address);
+
+const DESTINATION = address("FDx9mfVqTvXUaSPQDELwDtGgMqxirmAFsEK2s4YsKfsc");
+
+// Build a raw SOL transfer instruction
+const solTransferIx = getTransferSolInstruction({
+  source: createNoopSigner(address(account.address)),
+  destination: DESTINATION,
+  amount: 10n,
+});
+
+
+const result = await openfort.accounts.solana.backend.sendTransaction({
+  account,
+  cluster: "devnet",
+  instructions: [solTransferIx],
+});
+console.log("Transaction signature:", result.signature);

package/examples/solana/transactions/transfer.ts

@@ -0,0 +1,44 @@
+// Usage: pnpm tsx solana/transactions/transfer.ts
+
+import Openfort from "@openfort/openfort-node";
+import "dotenv/config";
+
+const openfort = new Openfort(process.env.OPENFORT_API_KEY!, {
+  basePath: process.env.OPENFORT_BASE_URL,
+  walletSecret: process.env.OPENFORT_WALLET_SECRET,
+  publishableKey: process.env.OPENFORT_PUBLISHABLE_KEY,
+});
+
+// Prefunded devnet account with some SOL and USDC for testing transfers
+const account = await openfort.accounts.solana.backend.get({
+  address: "o24A5URLU3JNKg7AoeUrPsfsAo1NQeeAB4uQViAkpjq",
+});
+console.log("Solana account:", account.address);
+
+const DEST = "FDx9mfVqTvXUaSPQDELwDtGgMqxirmAFsEK2s4YsKfsc";
+
+// --- Example 1: SOL transfer ---
+const solResult = await account.transfer({
+  to: DEST,
+  amount: 1_000_000n,
+  cluster: "devnet",
+});
+console.log("SOL transfer signature:", solResult.signature);
+
+// --- Example 2: USDC transfer by name ---
+const usdcResult = await account.transfer({
+  to: DEST,
+  amount: 1_000_000n,
+  token: "usdc",
+  cluster: "devnet",
+});
+console.log("USDC transfer signature:", usdcResult.signature);
+
+// --- Example 3: SPL transfer by mint address ---
+const splResult = await account.transfer({
+  to: DEST,
+  amount: 2_000_000n,
+  token: "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
+  cluster: "devnet",
+});
+console.log("SPL transfer signature:", splResult.signature);

package/knip.json

@@ -2,5 +2,14 @@
   "$schema": "https://unpkg.com/knip@latest/schema.json",
   "entry": ["src/index.ts!"],
   "project": ["src/**/*.ts!"],
-  "ignore": ["example/**"]
+  "ignore": ["example/**"],
+  "ignoreDependencies": [
+    "@solana-program/compute-budget",
+    "@solana-program/system",
+    "@solana-program/token",
+    "@solana/kit",
+    "@solana/kora",
+    "@solana/transaction-confirmation",
+    "viem"
+  ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfort/openfort-node",
-  "version": "0.9.3",
+  "version": "0.10.0",
   "description": "Openfort Node SDK",
   "author": "Openfort",
   "repository": {
@@ -40,24 +40,29 @@
   },
   "dependencies": {
     "@openfort/shield-js": "^0.1.35",
-    "@types/node": "^25.3.2",
-    "@types/node-fetch": "^2.6.13",
     "axios": "^1.13.6",
     "axios-retry": "^4.5.0",
     "bs58": "^6.0.0",
     "jose": "^5.10.0",
     "node-fetch": "^2.7.0",
-    "viem": "^2.46.3",
     "zod": "^3.25.76"
   },
   "simple-git-hooks": {
     "pre-commit": "pnpm check"
   },
   "devDependencies": {
+    "@types/node": "^25.3.2",
+    "@types/node-fetch": "^2.6.13",
     "@arethetypeswrong/cli": "^0.18.2",
     "@biomejs/biome": "^2.4.4",
     "@changesets/changelog-github": "^0.5.2",
     "@changesets/cli": "^2.29.8",
+    "@solana-program/compute-budget": "^0.14.0",
+    "@solana-program/system": "^0.12.0",
+    "@solana-program/token": "^0.12.0",
+    "@solana/kit": "^6.1.0",
+    "@solana/kora": "^0.1.3",
+    "@solana/transaction-confirmation": "^6.1.0",
     "@vitest/coverage-v8": "^3.2.4",
     "knip": "^5.85.0",
     "orval": "^8.5.1",
@@ -65,8 +70,41 @@
     "simple-git-hooks": "^2.13.1",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
+    "viem": "^2.46.3",
     "vitest": "^3.2.4"
   },
+  "peerDependencies": {
+    "@solana-program/compute-budget": ">=0.7.0",
+    "@solana-program/system": ">=0.7.0",
+    "@solana-program/token": ">=0.7.0",
+    "@solana/kit": ">=6.0.0",
+    "@solana/kora": ">=0.1.0",
+    "@solana/transaction-confirmation": ">=6.0.0",
+    "viem": ">=2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@solana/kit": {
+      "optional": true
+    },
+    "@solana-program/compute-budget": {
+      "optional": true
+    },
+    "@solana-program/system": {
+      "optional": true
+    },
+    "@solana-program/token": {
+      "optional": true
+    },
+    "@solana/kora": {
+      "optional": true
+    },
+    "@solana/transaction-confirmation": {
+      "optional": true
+    },
+    "viem": {
+      "optional": true
+    }
+  },
   "scripts": {
     "prebuild": "node -p \"'export const VERSION = ' + JSON.stringify(require('./package.json').version) + ';\\nexport const PACKAGE = ' + JSON.stringify(require('./package.json').name) + ';'\" > src/version.ts",
     "build": "tsup",

package/tsconfig.json

@@ -11,19 +11,18 @@
     "lib": ["es2022", "esnext.disposable", "dom"],
     "typeRoots": ["node_modules/@types", "./typings"],
     "downlevelIteration": true,
-    "experimentalDecorators": true,
     "declaration": true,
     "strictNullChecks": true,
     "newLine": "LF",
     "noUnusedParameters": false,
     "noUnusedLocals": false,
-    "emitDecoratorMetadata": true,
     "noImplicitThis": true,
     "noImplicitReturns": true,
     "noFallthroughCasesInSwitch": true,
     "strictBindCallApply": true,
     "esModuleInterop": true,
-    "resolveJsonModule": true
+    "resolveJsonModule": true,
+    "skipLibCheck": true
   },
   "include": ["src/**/*"],
   "exclude": ["dist", "example"]

package/examples/policies/createAccountPolicy.ts

@@ -1,71 +0,0 @@
-// Usage: npx tsx policies/createAccountPolicy.ts
-//
-// Creates an account-scoped policy (as opposed to project-scoped).
-// Account policies apply only to a specific wallet account.
-
-import Openfort, {
-  CreatePolicyBodySchema,
-  type CreatePolicyBody,
-} from "@openfort/openfort-node";
-import "dotenv/config";
-
-const openfort = new Openfort(process.env.OPENFORT_API_KEY!, {
-  basePath: process.env.OPENFORT_BASE_URL,
-  walletSecret: process.env.OPENFORT_WALLET_SECRET,
-});
-
-// Create an EVM backend wallet to attach the policy to
-const account = await openfort.accounts.evm.backend.create();
-console.log("Created account:", account.id);
-
-// ---------------------------------------------------------------------------
-// Create an account-scoped policy
-// ---------------------------------------------------------------------------
-
-const body: CreatePolicyBody = {
-  scope: "account",
-  accountId: account.id,
-  description: "Account-level allowlist for this specific wallet",
-  enabled: true,
-  priority: 10,
-  rules: [
-    {
-      action: "accept",
-      operation: "signEvmTransaction",
-      criteria: [
-        {
-          type: "evmAddress",
-          operator: "in",
-          addresses: ["0x000000000000000000000000000000000000dEaD"],
-        },
-        {
-          type: "ethValue",
-          operator: "<=",
-          ethValue: "500000000000000000", // 0.5 ETH
-        },
-      ],
-    },
-    {
-      action: "accept",
-      operation: "signEvmMessage",
-      criteria: [
-        {
-          type: "evmMessage",
-          operator: "match",
-          pattern: "^Sign in to",
-        },
-      ],
-    },
-  ],
-};
-
-CreatePolicyBodySchema.parse(body);
-
-const policy = await openfort.policies.create(body);
-
-console.log("\nCreated account-scoped policy:");
-console.log("  ID:", policy.id);
-console.log("  Scope:", policy.scope);
-console.log("  Account:", policy.accountId);
-console.log("  Priority:", policy.priority);
-console.log("  Rules:", policy.rules.length);

package/examples/policies/createEvmPolicy.ts

@@ -1,149 +0,0 @@
-// Usage: npx tsx policies/createEvmPolicy.ts
-//
-// Creates policies that control EVM signing operations.
-// Demonstrates: ethValue limits, address allowlists, network restrictions,
-// and combined criteria.
-
-import Openfort, {
-  CreatePolicyBodySchema,
-  type CreatePolicyBody,
-} from "@openfort/openfort-node";
-import "dotenv/config";
-
-const openfort = new Openfort(process.env.OPENFORT_API_KEY!, {
-  basePath: process.env.OPENFORT_BASE_URL,
-});
-
-// ---------------------------------------------------------------------------
-// 1. Reject high-value EVM transactions (> 1 ETH)
-// ---------------------------------------------------------------------------
-
-const highValueBody: CreatePolicyBody = {
-  scope: "project",
-  description: "Reject transactions above 1 ETH",
-  rules: [
-    {
-      action: "reject",
-      operation: "signEvmTransaction",
-      criteria: [
-        {
-          type: "ethValue",
-          operator: ">",
-          ethValue: "1000000000000000000", // 1 ETH in wei
-        },
-      ],
-    },
-  ],
-};
-
-// Validate with Zod before sending
-CreatePolicyBodySchema.parse(highValueBody);
-
-const highValuePolicy = await openfort.policies.create(highValueBody);
-console.log("Created high-value rejection policy:");
-console.log("  ID:", highValuePolicy.id);
-console.log("  Scope:", highValuePolicy.scope);
-console.log("  Rules:", highValuePolicy.rules.length);
-
-// ---------------------------------------------------------------------------
-// 2. Address allowlist — only allow transactions to known addresses
-// ---------------------------------------------------------------------------
-
-const allowlistBody: CreatePolicyBody = {
-  scope: "project",
-  description: "Only allow transfers to treasury and vault",
-  rules: [
-    {
-      action: "accept",
-      operation: "sendEvmTransaction",
-      criteria: [
-        {
-          type: "evmAddress",
-          operator: "in",
-          addresses: [
-            "0x000000000000000000000000000000000000dEaD",
-            "0x1234567890abcdef1234567890abcdef12345678",
-          ],
-        },
-        {
-          type: "evmNetwork",
-          operator: "in",
-          chainIds: [1, 137, 8453], // Ethereum, Polygon, Base
-        },
-      ],
-    },
-  ],
-};
-
-CreatePolicyBodySchema.parse(allowlistBody);
-
-const allowlistPolicy = await openfort.policies.create(allowlistBody);
-console.log("\nCreated address allowlist policy:");
-console.log("  ID:", allowlistPolicy.id);
-
-// ---------------------------------------------------------------------------
-// 3. Restrict EVM contract calls by ABI function
-// ---------------------------------------------------------------------------
-
-const dataBody: CreatePolicyBody = {
-  scope: "project",
-  description: "Only allow ERC-20 transfer calls",
-  rules: [
-    {
-      action: "accept",
-      operation: "signEvmTransaction",
-      criteria: [
-        {
-          type: "evmData",
-          operator: "==",
-          abi: '[{"type":"function","name":"transfer","inputs":[{"name":"to","type":"address"},{"name":"amount","type":"uint256"}],"outputs":[{"type":"bool"}]}]',
-          functionName: "transfer",
-        },
-      ],
-    },
-  ],
-};
-
-CreatePolicyBodySchema.parse(dataBody);
-
-const dataPolicy = await openfort.policies.create(dataBody);
-console.log("\nCreated ERC-20 transfer-only policy:");
-console.log("  ID:", dataPolicy.id);
-
-// ---------------------------------------------------------------------------
-// 4. Combined: value cap + address allowlist + network restriction
-// ---------------------------------------------------------------------------
-
-const combinedBody: CreatePolicyBody = {
-  scope: "project",
-  description: "Accept low-value sends to known addresses on mainnet only",
-  rules: [
-    {
-      action: "accept",
-      operation: "sendEvmTransaction",
-      criteria: [
-        {
-          type: "ethValue",
-          operator: "<=",
-          ethValue: "500000000000000000", // 0.5 ETH
-        },
-        {
-          type: "evmAddress",
-          operator: "in",
-          addresses: ["0x000000000000000000000000000000000000dEaD"],
-        },
-        {
-          type: "evmNetwork",
-          operator: "in",
-          chainIds: [1], // Ethereum mainnet only
-        },
-      ],
-    },
-  ],
-};
-
-CreatePolicyBodySchema.parse(combinedBody);
-
-const combinedPolicy = await openfort.policies.create(combinedBody);
-console.log("\nCreated combined EVM policy:");
-console.log("  ID:", combinedPolicy.id);