@actioncodes/protocol 1.0.3 → 1.1.1

package/dist/adapters/base.d.ts

@@ -11,13 +11,20 @@ export declare abstract class BaseChainAdapter<T = any> {
      * @param meta - ProtocolMetaV1 object
      * @returns Chain-specific encoded data
      */
-    abstract encode(meta: ProtocolMetaV1): any;
+    abstract encodeMeta(meta: ProtocolMetaV1): any;
     /**
      * Decode protocol meta from chain-specific transaction
      * @param tx - Chain-specific transaction
      * @returns Decoded ProtocolMetaV1 or null
      */
-    abstract decode(tx: T): ProtocolMetaV1 | null;
+    abstract decodeMeta(tx: T): ProtocolMetaV1 | null;
+    /**
+     * Inject protocol meta into chain-specific transaction
+     * @param tx - Chain-specific transaction
+     * @param meta - ProtocolMetaV1 object
+     * @returns Chain-specific transaction with injected meta
+     */
+    abstract injectMeta(tx: T, meta: ProtocolMetaV1): T;
     /**
      * Validate transaction with protocol meta and authority list
      * @param tx - Chain-specific transaction
@@ -65,5 +72,15 @@ export declare abstract class BaseChainAdapter<T = any> {
      * @returns True if the code signature is valid
      */
     abstract verifyCodeSignature(actionCode: ActionCode): boolean;
+    /**
+     * Sign the transaction with the protocol key using a callback approach
+     * This method should be implemented by each chain-specific adapter to handle
+     * the chain's specific signing mechanism asynchronously
+     * @param tx - Chain-specific transaction to sign
+     * @param protocolPrivateKey - Private key or Keypair object depending on the chain
+     * @param signCallback - Callback function that performs the actual signing
+     * @returns Promise that resolves to the signed transaction
+     */
+    abstract signWithProtocolKey(actionCode: ActionCode, key: any): Promise<ActionCode>;
 }
 //# sourceMappingURL=base.d.ts.map

package/dist/adapters/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/adapters/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC;;;GAGG;AACH,8BAAsB,gBAAgB,CAAC,CAAC,GAAG,GAAG;IAC1C,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEhC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,GAAG;IAE1C;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,GAAG,cAAc,GAAG,IAAI;IAE7C;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO;IAEjF;;;;;OAKG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAE3D;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,cAAc,GAAE,MAAkB,GAAG,OAAO;IA8B1F;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,4BAA4B,CAAC,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO;IAErF;;;;;;OAMG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAE,MAA6B,GAAG,MAAM;IAIvG;;;;;;OAMG;IACH,QAAQ,CAAC,mBAAmB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO;CAChE"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/adapters/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC;;;GAGG;AACH,8BAAsB,gBAAgB,CAAC,CAAC,GAAG,GAAG;IAC1C,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEhC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,GAAG;IAE9C;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC,GAAG,cAAc,GAAG,IAAI;IAEjD;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,GAAG,CAAC;IAEnD;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO;IAEjF;;;;;OAKG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAE3D;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,cAAc,GAAE,MAAkB,GAAG,OAAO;IA8B1F;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,4BAA4B,CAAC,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO;IAErF;;;;;;OAMG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAE,MAA6B,GAAG,MAAM;IAIvG;;;;;;OAMG;IACH,QAAQ,CAAC,mBAAmB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO;IAE7D;;;;;;;;OAQG;IACH,QAAQ,CAAC,mBAAmB,CACxB,UAAU,EAAE,UAAU,EACtB,GAAG,EAAE,GAAG,GACT,OAAO,CAAC,UAAU,CAAC;CACzB"}

package/dist/adapters/base.js

@@ -16,7 +16,7 @@ class BaseChainAdapter {
      */
     detectTampering(tx, authorities, expectedPrefix = 'DEFAULT') {
         // First, decode the protocol meta from the transaction
-        const meta = this.decode(tx);
+        const meta = this.decodeMeta(tx);
         if (!meta) {
             return false; // No protocol meta found
         }

package/dist/adapters/solana/solana.d.ts

@@ -1,4 +1,4 @@
-import { Transaction, TransactionInstruction, VersionedTransaction } from '@solana/web3.js';
+import { Transaction, TransactionInstruction, VersionedTransaction, Keypair } from '@solana/web3.js';
 import { ProtocolMetaV1 } from '../../meta';
 import { BaseChainAdapter } from '../base';
 import { ActionCode } from '../../actioncode';
@@ -18,13 +18,20 @@ export declare class SolanaAdapter extends BaseChainAdapter<SolanaTransaction> {
      * @param meta - The protocol meta to encode
      * @returns TransactionInstruction for the memo
      */
-    encode(meta: ProtocolMetaV1): TransactionInstruction;
+    encodeMeta(meta: ProtocolMetaV1): TransactionInstruction;
     /**
      * Decode protocol meta from Solana transaction (legacy or versioned)
      * @param tx - The Solana transaction
      * @returns Decoded ProtocolMetaV1 or null if not found
      */
-    decode(tx: SolanaTransaction): ProtocolMetaV1 | null;
+    decodeMeta(tx: SolanaTransaction): ProtocolMetaV1 | null;
+    /**
+     * Inject protocol meta into Solana transaction
+     * @param tx - The Solana transaction
+     * @param meta - ProtocolMetaV1 object
+     * @returns Solana transaction with injected meta
+     */
+    injectMeta(tx: SolanaTransaction, meta: ProtocolMetaV1): SolanaTransaction;
     /**
      * Validate transaction with protocol meta and authority list
      * @param tx - The Solana transaction
@@ -82,5 +89,11 @@ export declare class SolanaAdapter extends BaseChainAdapter<SolanaTransaction> {
      */
     validateFromBase64(base64String: string, authorities: string[], expectedPrefix?: string): boolean;
     verifyCodeSignature(actionCode: ActionCode): boolean;
+    /**
+     * Sign the transaction with the protocol key using a callback approach
+     * @param signCallback - Callback function that performs the actual signing
+     * @returns Promise that resolves to the signed transaction
+     */
+    signWithProtocolKey(actionCode: ActionCode, key: Keypair): Promise<ActionCode>;
 }
 //# sourceMappingURL=solana.d.ts.map

package/dist/adapters/solana/solana.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"solana.d.ts","sourceRoot":"","sources":["../../../src/adapters/solana/solana.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,WAAW,EACX,sBAAsB,EACtB,oBAAoB,EAGvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,cAAc,EAAsB,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,oBAAoB,CAAC;AAEnE;;;GAGG;AACH,qBAAa,aAAc,SAAQ,gBAAgB,CAAC,iBAAiB,CAAC;IAClE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAmB;IAE1D,QAAQ,CAAC,KAAK,YAAY;IAE1B;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,sBAAsB;IAKpD;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,iBAAiB,GAAG,cAAc,GAAG,IAAI;IAWpD;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,cAAc,GAAE,MAAkB,GAAG,OAAO;IAInG;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAWlE;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqB/B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAUlC;;OAEG;IACH,OAAO,CAAC,eAAe;IAuBvB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAMhC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAenC;;;;;OAKG;IACH,SAAS,CAAC,4BAA4B,CAAC,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO;IAqB5F;;;;OAIG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAgB7D;;;;;;OAMG;IACH,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,cAAc,GAAE,MAAkB,GAAG,OAAO;IAiBrG,mBAAmB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO;CAY9D"}
+{"version":3,"file":"solana.d.ts","sourceRoot":"","sources":["../../../src/adapters/solana/solana.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,WAAW,EACX,sBAAsB,EACtB,oBAAoB,EAGpB,OAAO,EACV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,cAAc,EAAsB,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,oBAAoB,CAAC;AAEnE;;;GAGG;AACH,qBAAa,aAAc,SAAQ,gBAAgB,CAAC,iBAAiB,CAAC;IAClE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAmB;IAE1D,QAAQ,CAAC,KAAK,YAAY;IAE1B;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,sBAAsB;IAgBxD;;;;OAIG;IACH,UAAU,CAAC,EAAE,EAAE,iBAAiB,GAAG,cAAc,GAAG,IAAI;IAWxD;;;;;OAKG;IACH,UAAU,CAAC,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,cAAc,GAAG,iBAAiB;IA+C1E;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,cAAc,GAAE,MAAkB,GAAG,OAAO;IAInG;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAWlE;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqB/B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAUlC;;OAEG;IACH,OAAO,CAAC,eAAe;IAuBvB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAMhC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAenC;;;;;OAKG;IACH,SAAS,CAAC,4BAA4B,CAAC,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO;IA6B5F;;;;OAIG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAgB7D;;;;;;OAMG;IACH,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,cAAc,GAAE,MAAkB,GAAG,OAAO;IAiBrG,mBAAmB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO;IAa3D;;;;OAIG;IACG,mBAAmB,CACrB,UAAU,EAAE,UAAU,EACtB,GAAG,EAAE,OAAO,GACb,OAAO,CAAC,UAAU,CAAC;CAkCzB"}

package/dist/adapters/solana/solana.js

@@ -54,16 +54,26 @@ class SolanaAdapter extends base_1.BaseChainAdapter {
      * @param meta - The protocol meta to encode
      * @returns TransactionInstruction for the memo
      */
-    encode(meta) {
+    encodeMeta(meta) {
         const metaString = meta_1.ProtocolMetaParser.serialize(meta);
-        return (0, spl_memo_1.createMemoInstruction)(metaString);
+        const signerPubkeys = [];
+        try {
+            if (meta.iss && meta.iss !== 'undefined') {
+                const pubkey = new web3_js_1.PublicKey(meta.iss);
+                signerPubkeys.push(pubkey);
+            }
+        }
+        catch (error) {
+            // Ignore error, issuer is not a valid public key
+        }
+        return (0, spl_memo_1.createMemoInstruction)(metaString, signerPubkeys);
     }
     /**
      * Decode protocol meta from Solana transaction (legacy or versioned)
      * @param tx - The Solana transaction
      * @returns Decoded ProtocolMetaV1 or null if not found
      */
-    decode(tx) {
+    decodeMeta(tx) {
         // Check if it's a versioned transaction
         if ('message' in tx && tx.message) {
             return this.decodeVersionedTransaction(tx);
@@ -75,6 +85,50 @@ class SolanaAdapter extends base_1.BaseChainAdapter {
             return null;
         }
     }
+    /**
+     * Inject protocol meta into Solana transaction
+     * @param tx - The Solana transaction
+     * @param meta - ProtocolMetaV1 object
+     * @returns Solana transaction with injected meta
+     */
+    injectMeta(tx, meta) {
+        const metaIx = this.encodeMeta(meta);
+        if (tx instanceof web3_js_1.VersionedTransaction) {
+            // Convert TransactionInstruction to MessageCompiledInstruction for versioned transactions
+            // First, ensure all required keys are in static account keys
+            metaIx.keys.forEach(({ pubkey }) => {
+                if (!tx.message.staticAccountKeys.some(key => key.equals(pubkey))) {
+                    tx.message.staticAccountKeys.push(pubkey);
+                }
+            });
+            // Ensure programId is also in static keys
+            if (!tx.message.staticAccountKeys.some(key => key.equals(metaIx.programId))) {
+                tx.message.staticAccountKeys.push(metaIx.programId);
+            }
+            // Now find the program ID index after ensuring it's in the static keys
+            const programIdIndex = tx.message.staticAccountKeys.findIndex(key => key.equals(metaIx.programId));
+            const accountKeyIndexes = metaIx.keys.map(key => {
+                const index = tx.message.staticAccountKeys.findIndex(staticKey => staticKey.equals(key.pubkey));
+                if (index === -1) {
+                    throw new Error(`Account key ${key.pubkey.toBase58()} not found in static account keys`);
+                }
+                return index;
+            });
+            const compiledInstruction = {
+                programIdIndex,
+                accountKeyIndexes,
+                data: metaIx.data
+            };
+            tx.message.compiledInstructions.push(compiledInstruction);
+        }
+        else if (tx instanceof web3_js_1.Transaction) {
+            tx.instructions.push(metaIx);
+        }
+        else {
+            throw new Error('Invalid transaction type');
+        }
+        return tx;
+    }
     /**
      * Validate transaction with protocol meta and authority list
      * @param tx - The Solana transaction
@@ -114,13 +168,13 @@ class SolanaAdapter extends base_1.BaseChainAdapter {
                     try {
                         const memoString = new TextDecoder().decode(memoData);
                         const meta = meta_1.ProtocolMetaParser.parse(memoString);
-                        if (meta && meta.version !== '1') {
-                            return null;
+                        if (meta && meta.version === '1') {
+                            return meta;
                         }
-                        return meta;
+                        // Continue searching if this memo is not a valid protocol meta
                     }
                     catch {
-                        return null;
+                        // Continue searching if this memo cannot be parsed
                     }
                 }
             }
@@ -151,13 +205,13 @@ class SolanaAdapter extends base_1.BaseChainAdapter {
                     try {
                         const memoString = new TextDecoder().decode(memoData);
                         const meta = meta_1.ProtocolMetaParser.parse(memoString);
-                        if (meta && meta.version !== '1') {
-                            return null;
+                        if (meta && meta.version === '1') {
+                            return meta;
                         }
-                        return meta;
+                        // Continue searching if this memo is not a valid protocol meta
                     }
                     catch {
-                        return null;
+                        // Continue searching if this memo cannot be parsed
                     }
                 }
             }
@@ -195,10 +249,16 @@ class SolanaAdapter extends base_1.BaseChainAdapter {
         // Additional Solana-specific validation can be added here
         // For example, checking transaction signatures, recent blockhash, etc.
         // Verify that the memo instruction contains the expected protocol meta
-        const decodedMeta = this.decode(tx);
+        const decodedMeta = this.decodeMeta(tx);
         if (!decodedMeta) {
             return false;
         }
+        if (!meta.iss) {
+            return false;
+        }
+        if (!this.hasIssuerSignature(tx, meta.iss)) {
+            return false;
+        }
         // Cross-check the decoded meta with the provided meta
         return (decodedMeta.version === meta.version &&
             decodedMeta.prefix === meta.prefix &&
@@ -218,11 +278,11 @@ class SolanaAdapter extends base_1.BaseChainAdapter {
             // Try legacy first, then versioned
             try {
                 const transaction = web3_js_1.Transaction.from(buffer);
-                return this.decode(transaction);
+                return this.decodeMeta(transaction);
             }
             catch {
                 const transaction = web3_js_1.VersionedTransaction.deserialize(buffer);
-                return this.decode(transaction);
+                return this.decodeMeta(transaction);
             }
         }
         catch {
@@ -265,6 +325,39 @@ class SolanaAdapter extends base_1.BaseChainAdapter {
             return false;
         }
     }
+    /**
+     * Sign the transaction with the protocol key using a callback approach
+     * @param signCallback - Callback function that performs the actual signing
+     * @returns Promise that resolves to the signed transaction
+     */
+    async signWithProtocolKey(actionCode, key) {
+        try {
+            if (!actionCode.transaction?.transaction) {
+                throw new Error('No transaction found');
+            }
+            const tx = web3_js_1.Transaction.from(buffer_1.Buffer.from(actionCode.transaction.transaction, 'base64'));
+            tx.partialSign(key);
+            const meta = this.decodeMeta(tx);
+            if (!meta) {
+                throw new Error('Invalid transaction, protocol meta not found');
+            }
+            if (!this.validateTransactionIntegrity(tx, meta)) {
+                throw new Error('Invalid transaction, transaction integrity not valid');
+            }
+            const newActionCode = Object.assign({}, actionCode, {
+                transaction: {
+                    ...actionCode.transaction,
+                    transaction: buffer_1.Buffer.from(tx.serialize({
+                        requireAllSignatures: false
+                    })).toString('base64'),
+                }
+            });
+            return newActionCode;
+        }
+        catch (error) {
+            throw new Error(`Failed to sign transaction with protocol key: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
 }
 exports.SolanaAdapter = SolanaAdapter;
 SolanaAdapter.MEMO_PROGRAM_ID = spl_memo_1.MEMO_PROGRAM_ID;

package/dist/protocol.js

@@ -180,7 +180,7 @@ class ActionCodesProtocol {
         if (!adapter) {
             throw new Error(`Chain '${chain}' is not supported`);
         }
-        return adapter.encode(meta);
+        return adapter.encodeMeta(meta);
     }
     /**
      * Decode protocol meta from a transaction
@@ -193,7 +193,7 @@ class ActionCodesProtocol {
         if (!adapter) {
             return null;
         }
-        return adapter.decode(transaction);
+        return adapter.decodeMeta(transaction);
     }
     /**
      * Validate a transaction with protocol meta
@@ -251,7 +251,7 @@ class ActionCodesProtocol {
         if (!adapter) {
             return null;
         }
-        return adapter.decode(transaction);
+        return adapter.decodeMeta(transaction);
     }
     /**
      * Get protocol configuration

package/docs/actioncode/classes/ActionCode.md

@@ -6,7 +6,7 @@
 
 # Class: ActionCode
 
-Defined in: [actioncode.ts:32](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L32)
+Defined in: [actioncode.ts:32](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L32)
 
 ## Constructors
 
@@ -14,7 +14,7 @@ Defined in: [actioncode.ts:32](https://github.com/otaprotocol/actioncodes/blob/0
 
 > **new ActionCode**(`fields`): `ActionCode`
 
-Defined in: [actioncode.ts:33](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L33)
+Defined in: [actioncode.ts:33](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L33)
 
 #### Parameters
 
@@ -34,7 +34,7 @@ Defined in: [actioncode.ts:33](https://github.com/otaprotocol/actioncodes/blob/0
 
 > **get** **chain**(): `string`
 
-Defined in: [actioncode.ts:95](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L95)
+Defined in: [actioncode.ts:95](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L95)
 
 Get the target chain for this action code
 
@@ -52,7 +52,7 @@ Chain identifier (e.g., "solana", "evm")
 
 > **get** **code**(): `string`
 
-Defined in: [actioncode.ts:111](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L111)
+Defined in: [actioncode.ts:111](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L111)
 
 Get the action code string
 
@@ -70,7 +70,7 @@ The 8-character action code
 
 > **get** **codeHash**(): `string`
 
-Defined in: [actioncode.ts:217](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L217)
+Defined in: [actioncode.ts:217](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L217)
 
 Get the code hash for this action code
 it is also used in the protocol meta as the code id
@@ -89,7 +89,7 @@ Code hash string
 
 > **get** **description**(): `undefined` \| `string`
 
-Defined in: [actioncode.ts:151](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L151)
+Defined in: [actioncode.ts:151](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L151)
 
 Get a human-readable description of the action
 
@@ -107,7 +107,7 @@ Description string or undefined
 
 > **get** **displayString**(): `string`
 
-Defined in: [actioncode.ts:183](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L183)
+Defined in: [actioncode.ts:183](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L183)
 
 Get a human-readable display string for the action code
 
@@ -125,7 +125,7 @@ Formatted display string
 
 > **get** **encoded**(): `string`
 
-Defined in: [actioncode.ts:47](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L47)
+Defined in: [actioncode.ts:47](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L47)
 
 ##### Returns
 
@@ -139,7 +139,7 @@ Defined in: [actioncode.ts:47](https://github.com/otaprotocol/actioncodes/blob/0
 
 > **get** **expired**(): `boolean`
 
-Defined in: [actioncode.ts:87](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L87)
+Defined in: [actioncode.ts:87](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L87)
 
 Check if the action code has expired
 
@@ -157,7 +157,7 @@ True if the code has expired
 
 > **get** **json**(): [`ActionCodeFields`](../interfaces/ActionCodeFields.md)
 
-Defined in: [actioncode.ts:68](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L68)
+Defined in: [actioncode.ts:68](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L68)
 
 ##### Returns
 
@@ -171,7 +171,7 @@ Defined in: [actioncode.ts:68](https://github.com/otaprotocol/actioncodes/blob/0
 
 > **get** **metadata**(): `undefined` \| [`ActionCodeMetadata`](../interfaces/ActionCodeMetadata.md)
 
-Defined in: [actioncode.ts:143](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L143)
+Defined in: [actioncode.ts:143](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L143)
 
 Get metadata associated with this action code
 
@@ -189,7 +189,7 @@ Metadata object or undefined
 
 > **get** **params**(): `undefined` \| `Record`\<`string`, `any`\>
 
-Defined in: [actioncode.ts:159](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L159)
+Defined in: [actioncode.ts:159](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L159)
 
 Get parameters associated with this action
 
@@ -207,7 +207,7 @@ Parameters object or undefined
 
 > **get** **prefix**(): `string`
 
-Defined in: [actioncode.ts:119](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L119)
+Defined in: [actioncode.ts:119](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L119)
 
 Get the prefix used for this action code
 
@@ -225,7 +225,7 @@ Normalized prefix
 
 > **get** **pubkey**(): `string`
 
-Defined in: [actioncode.ts:127](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L127)
+Defined in: [actioncode.ts:127](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L127)
 
 Get the user's public key
 
@@ -243,7 +243,7 @@ User's public key
 
 > **get** **remainingTime**(): `number`
 
-Defined in: [actioncode.ts:78](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L78)
+Defined in: [actioncode.ts:78](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L78)
 
 Get remaining time in milliseconds until expiration
 
@@ -261,7 +261,7 @@ Remaining time in milliseconds, or 0 if expired
 
 > **get** **remainingTimeString**(): `string`
 
-Defined in: [actioncode.ts:196](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L196)
+Defined in: [actioncode.ts:196](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L196)
 
 Get a formatted time string showing remaining time
 
@@ -279,7 +279,7 @@ Human-readable time string (e.g., "1m 30s remaining")
 
 > **get** **signature**(): `string`
 
-Defined in: [actioncode.ts:175](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L175)
+Defined in: [actioncode.ts:175](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L175)
 
 Get the user's signature
 
@@ -297,7 +297,7 @@ User's signature string
 
 > **get** **status**(): [`ActionCodeStatus`](../type-aliases/ActionCodeStatus.md)
 
-Defined in: [actioncode.ts:103](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L103)
+Defined in: [actioncode.ts:103](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L103)
 
 Get the current status of the action code
 
@@ -315,7 +315,7 @@ Current status
 
 > **get** **timestamp**(): `number`
 
-Defined in: [actioncode.ts:167](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L167)
+Defined in: [actioncode.ts:167](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L167)
 
 Get the timestamp when the code was generated
 
@@ -333,7 +333,7 @@ Timestamp in milliseconds
 
 > **get** **transaction**(): `undefined` \| [`ActionCodeTransaction`](../interfaces/ActionCodeTransaction.md)
 
-Defined in: [actioncode.ts:135](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L135)
+Defined in: [actioncode.ts:135](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L135)
 
 Get the transaction data (chain-specific)
 
@@ -349,7 +349,7 @@ Transaction data or undefined
 
 > **isValid**(`protocol`): `boolean`
 
-Defined in: [actioncode.ts:51](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L51)
+Defined in: [actioncode.ts:51](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L51)
 
 #### Parameters
 
@@ -367,7 +367,7 @@ Defined in: [actioncode.ts:51](https://github.com/otaprotocol/actioncodes/blob/0
 
 > `static` **fromEncoded**(`encoded`): `ActionCode`
 
-Defined in: [actioncode.ts:42](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L42)
+Defined in: [actioncode.ts:42](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L42)
 
 #### Parameters
 
@@ -385,7 +385,7 @@ Defined in: [actioncode.ts:42](https://github.com/otaprotocol/actioncodes/blob/0
 
 > `static` **fromPayload**(`input`): `ActionCode`
 
-Defined in: [actioncode.ts:35](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L35)
+Defined in: [actioncode.ts:35](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L35)
 
 #### Parameters
 

package/docs/actioncode/interfaces/ActionCodeFields.md

@@ -6,7 +6,7 @@
 
 # Interface: ActionCodeFields
 
-Defined in: [actioncode.ts:19](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L19)
+Defined in: [actioncode.ts:19](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L19)
 
 ## Properties
 
@@ -14,7 +14,7 @@ Defined in: [actioncode.ts:19](https://github.com/otaprotocol/actioncodes/blob/0
 
 > **chain**: `"solana"`
 
-Defined in: [actioncode.ts:25](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L25)
+Defined in: [actioncode.ts:25](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L25)
 
 ***
 
@@ -22,7 +22,7 @@ Defined in: [actioncode.ts:25](https://github.com/otaprotocol/actioncodes/blob/0
 
 > **code**: `string`
 
-Defined in: [actioncode.ts:20](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L20)
+Defined in: [actioncode.ts:20](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L20)
 
 ***
 
@@ -30,7 +30,7 @@ Defined in: [actioncode.ts:20](https://github.com/otaprotocol/actioncodes/blob/0
 
 > **expiresAt**: `number`
 
-Defined in: [actioncode.ts:28](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L28)
+Defined in: [actioncode.ts:28](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L28)
 
 ***
 
@@ -38,7 +38,7 @@ Defined in: [actioncode.ts:28](https://github.com/otaprotocol/actioncodes/blob/0
 
 > `optional` **metadata**: [`ActionCodeMetadata`](ActionCodeMetadata.md)
 
-Defined in: [actioncode.ts:27](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L27)
+Defined in: [actioncode.ts:27](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L27)
 
 ***
 
@@ -46,7 +46,7 @@ Defined in: [actioncode.ts:27](https://github.com/otaprotocol/actioncodes/blob/0
 
 > **prefix**: `string`
 
-Defined in: [actioncode.ts:21](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L21)
+Defined in: [actioncode.ts:21](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L21)
 
 ***
 
@@ -54,7 +54,7 @@ Defined in: [actioncode.ts:21](https://github.com/otaprotocol/actioncodes/blob/0
 
 > **pubkey**: `string`
 
-Defined in: [actioncode.ts:22](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L22)
+Defined in: [actioncode.ts:22](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L22)
 
 ***
 
@@ -62,7 +62,7 @@ Defined in: [actioncode.ts:22](https://github.com/otaprotocol/actioncodes/blob/0
 
 > **signature**: `string`
 
-Defined in: [actioncode.ts:24](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L24)
+Defined in: [actioncode.ts:24](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L24)
 
 ***
 
@@ -70,7 +70,7 @@ Defined in: [actioncode.ts:24](https://github.com/otaprotocol/actioncodes/blob/0
 
 > **status**: [`ActionCodeStatus`](../type-aliases/ActionCodeStatus.md)
 
-Defined in: [actioncode.ts:29](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L29)
+Defined in: [actioncode.ts:29](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L29)
 
 ***
 
@@ -78,7 +78,7 @@ Defined in: [actioncode.ts:29](https://github.com/otaprotocol/actioncodes/blob/0
 
 > **timestamp**: `number`
 
-Defined in: [actioncode.ts:23](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L23)
+Defined in: [actioncode.ts:23](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L23)
 
 ***
 
@@ -86,4 +86,4 @@ Defined in: [actioncode.ts:23](https://github.com/otaprotocol/actioncodes/blob/0
 
 > `optional` **transaction**: [`ActionCodeTransaction`](ActionCodeTransaction.md)
 
-Defined in: [actioncode.ts:26](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L26)
+Defined in: [actioncode.ts:26](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L26)

package/docs/actioncode/interfaces/ActionCodeMetadata.md

@@ -6,7 +6,7 @@
 
 # Interface: ActionCodeMetadata
 
-Defined in: [actioncode.ts:8](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L8)
+Defined in: [actioncode.ts:8](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L8)
 
 ## Properties
 
@@ -14,7 +14,7 @@ Defined in: [actioncode.ts:8](https://github.com/otaprotocol/actioncodes/blob/00
 
 > `optional` **description**: `string`
 
-Defined in: [actioncode.ts:9](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L9)
+Defined in: [actioncode.ts:9](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L9)
 
 ***
 
@@ -22,4 +22,4 @@ Defined in: [actioncode.ts:9](https://github.com/otaprotocol/actioncodes/blob/00
 
 > `optional` **params**: `Record`\<`string`, `any`\>
 
-Defined in: [actioncode.ts:10](https://github.com/otaprotocol/actioncodes/blob/007a9e0d8a0303f8bd7d2ee1ee5ee3e0ff8d987c/src/actioncode.ts#L10)
+Defined in: [actioncode.ts:10](https://github.com/otaprotocol/actioncodes/blob/57f8663219c9af5c455731c797e721cd72058ff4/src/actioncode.ts#L10)