@openfort/openfort-node 0.9.2 → 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"
+  ]
 }