@openfort/openfort-node 0.9.3 → 0.10.0

package/examples/evm/policies/createAccountPolicy.ts

@@ -0,0 +1,68 @@
+// Usage: pnpm tsx evm/policies/createAccountPolicy.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: "Account Allowlist Example",
+  rules: [
+    {
+      action: "accept",
+      operation: "signEvmTransaction",
+      criteria: [
+        {
+          type: "ethValue",
+          ethValue: "1000000000000000000",
+          operator: "<=",
+        },
+        {
+          type: "evmAddress",
+          addresses: ["0x000000000000000000000000000000000000dEaD"],
+          operator: "in",
+        },
+      ],
+    },
+    {
+      action: "accept",
+      operation: "sendEvmTransaction",
+      criteria: [
+        {
+          type: "ethValue",
+          ethValue: "1000000000000000000",
+          operator: "<=",
+        },
+        {
+          type: "evmAddress",
+          addresses: ["0x000000000000000000000000000000000000dEaD"],
+          operator: "in",
+        },
+        {
+          type: "evmNetwork",
+          chainIds: [8453],
+          operator: "in",
+        },
+      ],
+    },
+    {
+      action: "accept",
+      operation: "signEvmHash",
+    },
+    {
+      action: "accept",
+      operation: "signEvmMessage",
+      criteria: [
+        {
+          type: "evmMessage",
+          operator: "match",
+          pattern: ".*",
+        },
+      ],
+    },
+  ],
+});
+console.log("Created account policy: ", policy.id);

package/examples/evm/policies/createProjectPolicy.ts

@@ -0,0 +1,53 @@
+// Usage: pnpm tsx evm/policies/createProjectPolicy.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: "project",
+  description: "Project Allowlist Example",
+  rules: [
+    {
+      action: "accept",
+      operation: "signEvmTransaction",
+      criteria: [
+        {
+          type: "ethValue",
+          ethValue: "1000000000000000000",
+          operator: "<=",
+        },
+        {
+          type: "evmAddress",
+          addresses: ["0x000000000000000000000000000000000000dEaD"],
+          operator: "in",
+        },
+      ],
+    },
+    {
+      action: "accept",
+      operation: "sendEvmTransaction",
+      criteria: [
+        {
+          type: "ethValue",
+          ethValue: "1000000000000000000",
+          operator: "<=",
+        },
+        {
+          type: "evmAddress",
+          addresses: ["0x000000000000000000000000000000000000dEaD"],
+          operator: "in",
+        },
+        {
+          type: "evmNetwork",
+          chainIds: [8453],
+          operator: "in",
+        },
+      ],
+    },
+  ],
+});
+console.log("Created project policy: ", policy.id);

package/examples/evm/policies/deletePolicy.ts

@@ -0,0 +1,34 @@
+// Usage: pnpm tsx evm/policies/deletePolicy.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: "Temporary Policy",
+  rules: [
+    {
+      action: "accept",
+      operation: "signEvmTransaction",
+      criteria: [
+        {
+          type: "ethValue",
+          ethValue: "1000000000000000000",
+          operator: "<=",
+        },
+        {
+          type: "evmAddress",
+          addresses: ["0x000000000000000000000000000000000000dEaD"],
+          operator: "in",
+        },
+      ],
+    },
+  ],
+});
+
+await openfort.policies.delete(policy.id);
+console.log("Deleted policy: ", policy.id);

package/examples/evm/policies/getPolicyById.ts

@@ -0,0 +1,34 @@
+// Usage: pnpm tsx evm/policies/getPolicyById.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: "Account Policy",
+  rules: [
+    {
+      action: "accept",
+      operation: "signEvmTransaction",
+      criteria: [
+        {
+          type: "ethValue",
+          ethValue: "1000000000000000000",
+          operator: "<=",
+        },
+        {
+          type: "evmAddress",
+          addresses: ["0x000000000000000000000000000000000000dEaD"],
+          operator: "in",
+        },
+      ],
+    },
+  ],
+});
+
+const retrievedPolicy = await openfort.policies.get(policy.id);
+console.log("Retrieved policy: ", JSON.stringify(retrievedPolicy, null, 2));

package/examples/evm/policies/listAccountPolicies.ts

@@ -0,0 +1,11 @@
+// Usage: pnpm tsx evm/policies/listAccountPolicies.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 policies = await openfort.policies.list({ scope: ["account"] });
+console.log("Listed account policies: ", JSON.stringify(policies, null, 2));

package/examples/evm/policies/listPolicies.ts

@@ -0,0 +1,11 @@
+// Usage: pnpm tsx evm/policies/listPolicies.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 policies = await openfort.policies.list();
+console.log("Listed policies: ", JSON.stringify(policies, null, 2));

package/examples/evm/policies/listProjectPolicies.ts

@@ -0,0 +1,11 @@
+// Usage: pnpm tsx evm/policies/listProjectPolicies.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 policies = await openfort.policies.list({ scope: ["project"] });
+console.log("Listed project policies: ", JSON.stringify(policies, null, 2));

package/examples/evm/policies/signTypedDataPolicy.ts

@@ -0,0 +1,35 @@
+// Usage: pnpm tsx evm/policies/signTypedDataPolicy.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 restricts EIP-712 Permit signatures to a max value of 1000 tokens
+const permitPolicy = await openfort.policies.create({
+  scope: "account",
+  description: "Restrict Permit signatures to max 1000 tokens",
+  rules: [
+    {
+      action: "accept",
+      operation: "signEvmTypedData",
+      criteria: [
+        {
+          type: "evmTypedDataVerifyingContract",
+          addresses: ["0x000000000000000000000000000000000000dEaD"],
+          operator: "in",
+        },
+        {
+          type: "evmTypedDataField",
+          fieldPath: "value",
+          operator: "<=",
+          value: "1000000000000000000000", // Max 1000 tokens (assuming 18 decimals)
+        },
+      ],
+    },
+  ],
+});
+
+console.log("Created permit policy. Policy ID:", permitPolicy.id);

package/examples/evm/policies/updatePolicy.ts

@@ -0,0 +1,44 @@
+// Usage: pnpm tsx evm/policies/updatePolicy.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: "Initial Allowlist Policy",
+  rules: [
+    {
+      action: "accept",
+      operation: "signEvmTransaction",
+      criteria: [
+        {
+          type: "evmAddress",
+          addresses: ["0x000000000000000000000000000000000000dEaD"],
+          operator: "in",
+        },
+      ],
+    },
+  ],
+});
+
+const updatedPolicy = await openfort.policies.update(policy.id, {
+  description: "Updated Denylist Policy",
+  rules: [
+    {
+      action: "accept",
+      operation: "signEvmTransaction",
+      criteria: [
+        {
+          type: "evmAddress",
+          addresses: ["0x000000000000000000000000000000000000dEaD"],
+          operator: "not in",
+        },
+      ],
+    },
+  ],
+});
+console.log("Updated policy: ", JSON.stringify(updatedPolicy, null, 2));

package/examples/evm/policies/validation.ts

@@ -0,0 +1,45 @@
+// Usage: pnpm tsx evm/policies/validation.ts
+
+import { CreatePolicyBodySchema, UpdatePolicyBodySchema } from "@openfort/openfort-node";
+
+const invalidPolicy = {
+  description: 'Bad description with !#@ characters, also is wayyyyy toooooo long!!',
+  rules: [
+    {
+      action: 'accept',
+      operation: 'signEvmTransaction',
+      criteria: [
+        {
+          type: 'ethValue',
+          ethValue: 'not a number',
+          operator: '<='
+        },
+        {
+          type: 'evmAddress',
+          addresses: ["not an address"],
+          operator: 'in'
+        },
+        {
+          type: 'evmAddress',
+          addresses: ["not an address"],
+          operator: 'invalid operator'
+        }
+      ]
+    },
+    {
+      action: 'accept',
+      operation: 'unknownOperation',
+      criteria: []
+    },
+    {
+      action: 'accept',
+      operation: 'signEvmTransaction',
+      criteria: []
+    }
+  ]
+}
+
+// Validate a new Policy with several issues, will throw a ZodError with actionable validation errors
+CreatePolicyBodySchema.parse(invalidPolicy)
+// OR
+UpdatePolicyBodySchema.parse(invalidPolicy)

package/examples/evm/transactions/sendTransaction.ts

@@ -0,0 +1,44 @@
+// Usage: pnpm tsx evm/transactions/sendTransaction.ts
+
+import 'dotenv/config'
+import Openfort from '@openfort/openfort-node'
+
+const openfort = new Openfort(process.env.OPENFORT_API_KEY!, {
+  walletSecret: process.env.OPENFORT_WALLET_SECRET!,
+})
+
+
+// 1. Create an EVM backend account
+const account = await openfort.accounts.evm.backend.create()
+// const signedAuthorization = await account.sign({ hash: authHash })
+
+const interactions = [
+  { to: '0x0000000000000000000000000000000000000000', value: '0', data: '0x' },
+]
+
+console.log("=== Full delegation + signing flow via sendTransaction() ===")
+
+// 2. First call: account is new -> delegates via EIP-7702, then sends the transaction
+const result = await openfort.accounts.evm.backend.sendTransaction({
+  account: account,
+  chainId: 84532, // Base Sepolia
+  interactions,
+  // To send the transaction without native token in the wallet, use a fee sponsor.
+  // https://www.openfort.io/docs/configuration/gas-sponsorship
+  // policy: pol_...,
+});
+
+console.log("First tx", result.response?.transactionHash)
+
+// 3. Second call: account is already delegated -> skips delegation, sends directly
+const result2 = await openfort.accounts.evm.backend.sendTransaction({
+  account: account,
+  chainId: 84532,
+  interactions,
+  // To send the transaction without native token in the wallet, use a fee sponsor.
+  // https://www.openfort.io/docs/configuration/gas-sponsorship
+  // policy: pol_...,
+})
+console.log("Second tx", result2.response?.transactionHash)
+
+

package/examples/package.json

@@ -23,9 +23,22 @@
   },
   "dependencies": {
     "@openfort/openfort-node": "link:..",
+    "@solana-program/compute-budget": "^0.14.0",
+    "@solana-program/memo": "^0.11.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",
     "@types/express": "^4.17.17",
     "dotenv": "^16.3.1",
     "express": "^4.19.2",
     "viem": "^2.21.0"
+  },
+  "pnpm": {
+    "overrides": {
+      "@solana/kora>@solana/kit": "$@solana/kit",
+      "@solana/kora>@solana-program/token": "$@solana-program/token"
+    }
   }
 }