✨ Session keys

Anchor.toml

@@ -39,14 +39,11 @@ members = [
 test = """
 echo "Waiting for 2 seconds..."
 sleep 2
-echo "Running low level API tests..."
-yarn run ts-mocha -p ./tsconfig.json -t 1000000 tests/bolt.low-level.api.ts
-echo "Running intermediate level API tests..."
-yarn run ts-mocha -p ./tsconfig.json -t 1000000 tests/bolt.intermediate-level.api.ts
+yarn run ts-mocha -p ./tsconfig.json -t 1000000 tests/main.ts
 """
 
 [test]
-startup_wait = 5000
+startup_wait = 15000
 shutdown_wait = 2000
 upgradeable = false
 
@@ -55,6 +52,11 @@ address = "DELeGGvXpWV2fqJUhqcF5ZSYMS4JTLjteaAMARRSaeSh"
 program = "tests/fixtures/delegation.so"
 upgradeable = false
 
+[[test.genesis]]
+address="KeyspM2ssCJbqUhQ4k7sveSiY4WjnYsrXkC8oDbwde5"
+program="tests/fixtures/session_keys.so"
+upgradeable = false
+
 [test.validator]
 bind_address = "0.0.0.0"
 ledger = ".anchor/test-ledger"

Cargo.toml

@@ -34,6 +34,7 @@ bolt-system = { path = "crates/programs/bolt-system", features = ["cpi"], versio
 bolt-component = { path = "crates/programs/bolt-component", features = ["cpi"], version = "=0.2.0"}
 
 ## External crates
+session-keys = { version = "=2.0.6", features = ["no-entrypoint"] }
 anchor-lang = { version = "=0.30.1", features = ["init-if-needed"] }
 anchor-cli = { version = "=0.30.1" }
 anchor-client = { version = "=0.30.1" }

clients/bolt-sdk/src/generated/idl/gpl_session.json

@@ -0,0 +1,231 @@
+{
+  "address": "KeyspM2ssCJbqUhQ4k7sveSiY4WjnYsrXkC8oDbwde5",
+  "metadata": {
+    "name": "gpl_session",
+    "version": "2.0.6",
+    "spec": "0.1.0",
+    "description": "Gum Session Protocol (GPL Session)",
+    "repository": "https://github.com/magicblock-labs/gum-program-library"
+  },
+  "instructions": [
+    {
+      "name": "create_session",
+      "discriminator": [
+        242,
+        193,
+        143,
+        179,
+        150,
+        25,
+        122,
+        227
+      ],
+      "accounts": [
+        {
+          "name": "session_token",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  115,
+                  101,
+                  115,
+                  115,
+                  105,
+                  111,
+                  110,
+                  95,
+                  116,
+                  111,
+                  107,
+                  101,
+                  110
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "target_program"
+              },
+              {
+                "kind": "account",
+                "path": "session_signer"
+              },
+              {
+                "kind": "account",
+                "path": "authority"
+              }
+            ]
+          }
+        },
+        {
+          "name": "session_signer",
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "authority",
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "target_program",
+          "docs": [
+            "CHECK the target program is actually a program."
+          ]
+        },
+        {
+          "name": "system_program",
+          "address": "11111111111111111111111111111111"
+        }
+      ],
+      "args": [
+        {
+          "name": "top_up",
+          "type": {
+            "option": "bool"
+          }
+        },
+        {
+          "name": "valid_until",
+          "type": {
+            "option": "i64"
+          }
+        },
+        {
+          "name": "lamports",
+          "type": {
+            "option": "u64"
+          }
+        }
+      ]
+    },
+    {
+      "name": "revoke_session",
+      "discriminator": [
+        86,
+        92,
+        198,
+        120,
+        144,
+        2,
+        7,
+        194
+      ],
+      "accounts": [
+        {
+          "name": "session_token",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  115,
+                  101,
+                  115,
+                  115,
+                  105,
+                  111,
+                  110,
+                  95,
+                  116,
+                  111,
+                  107,
+                  101,
+                  110
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "session_token.target_program",
+                "account": "SessionToken"
+              },
+              {
+                "kind": "account",
+                "path": "session_token.session_signer",
+                "account": "SessionToken"
+              },
+              {
+                "kind": "account",
+                "path": "session_token.authority",
+                "account": "SessionToken"
+              }
+            ]
+          }
+        },
+        {
+          "name": "authority",
+          "writable": true,
+          "relations": [
+            "session_token"
+          ]
+        },
+        {
+          "name": "system_program",
+          "address": "11111111111111111111111111111111"
+        }
+      ],
+      "args": []
+    }
+  ],
+  "accounts": [
+    {
+      "name": "SessionToken",
+      "discriminator": [
+        233,
+        4,
+        115,
+        14,
+        46,
+        21,
+        1,
+        15
+      ]
+    }
+  ],
+  "errors": [
+    {
+      "code": 6000,
+      "name": "ValidityTooLong",
+      "msg": "Requested validity is too long"
+    },
+    {
+      "code": 6001,
+      "name": "InvalidToken",
+      "msg": "Invalid session token"
+    },
+    {
+      "code": 6002,
+      "name": "NoToken",
+      "msg": "No session token provided"
+    }
+  ],
+  "types": [
+    {
+      "name": "SessionToken",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "authority",
+            "type": "pubkey"
+          },
+          {
+            "name": "target_program",
+            "type": "pubkey"
+          },
+          {
+            "name": "session_signer",
+            "type": "pubkey"
+          },
+          {
+            "name": "valid_until",
+            "type": "i64"
+          }
+        ]
+      }
+    }
+  ]
+}

clients/bolt-sdk/src/generated/idl/world.json

@@ -111,6 +111,10 @@
         },
         {
           "name": "world"
+        },
+        {
+          "name": "session_token",
+          "optional": true
         }
       ],
       "args": [

clients/bolt-sdk/src/generated/index.ts

@@ -8,6 +8,7 @@
 import { PublicKey } from "@solana/web3.js";
 import { type World as WorldProgram } from "./types/world";
 import idl from "./idl/world.json";
+import gpl_session from "./idl/gpl_session.json";
 export * from "./accounts";
 export * from "./errors";
 export * from "./instructions";
@@ -30,3 +31,4 @@ export const PROGRAM_ID = new PublicKey(PROGRAM_ADDRESS);
 
 export default WorldProgram;
 export { idl as worldIdl };
+export { gpl_session as sessionIdl };

clients/bolt-sdk/src/generated/types/world.ts

@@ -91,6 +91,10 @@ export type World = {
         {
           name: "world";
         },
+        {
+          name: "sessionToken";
+          optional: true;
+        },
       ];
       args: [
         {

clients/bolt-sdk/src/index.ts

@@ -1,7 +1,8 @@
 import { PublicKey } from "@solana/web3.js";
-import type BN from "bn.js";
+import BN from "bn.js";
 import { PROGRAM_ID as WORLD_PROGRAM_ID } from "./generated";
 import { World as WORLD_PROGRAM_IDL } from "./generated/types";
+export { BN };
 export * from "./generated/accounts";
 export * from "./generated/instructions";
 export * from "./world/transactions";
@@ -11,6 +12,7 @@ export { DELEGATION_PROGRAM_ID } from "@magicblock-labs/ephemeral-rollups-sdk";
 
 // Re-export anchor
 import * as anchor from "@coral-xyz/anchor";
+import { SessionProgram, Session } from "./session";
 export { anchor };
 export { Provider, Program, Wallet, web3, workspace } from "@coral-xyz/anchor";
 export { WORLD_PROGRAM_ID, WORLD_PROGRAM_IDL };
@@ -68,6 +70,24 @@ export function FindEntityPda({
   )[0];
 }
 
+export function FindSessionTokenPda({
+  sessionSigner,
+  authority,
+}: {
+  sessionSigner: PublicKey;
+  authority: PublicKey;
+}) {
+  return PublicKey.findProgramAddressSync(
+    [
+      Buffer.from("session_token"),
+      WORLD_PROGRAM_ID.toBytes(),
+      sessionSigner.toBytes(),
+      authority.toBytes(),
+    ],
+    SessionProgram.programId,
+  )[0];
+}
+
 // TODO: seed must be Uint8Array like the other FindPda functions
 export function FindComponentPda({
   componentId,
@@ -99,3 +119,5 @@ export function SerializeArgs(args: any = {}) {
     binaryData.byteLength,
   );
 }
+
+export { SessionProgram, Session };