@actioncodes/protocol 1.0.0 → 1.0.2

package/README.md

@@ -1,6 +1,6 @@
 # 🛡️ Action Codes Protocol
 
-![Coverage](https://img.shields.io/badge/coverage-99.25%25-brightgreen)
+![Coverage](https://img.shields.io/badge/coverage-98%-brightgreen)
 
 **Action Codes Protocol** enables short-lived, cryptographically verifiable action codes that authorize blockchain transactions and intents without requiring live wallet sessions.
 

package/dist/actioncode.d.ts

@@ -1,34 +1,35 @@
 import { SUPPORTED_CHAINS } from "./constants";
+import { ActionCodesProtocol } from "./protocol";
 export type ActionCodeStatus = 'pending' | 'resolved' | 'finalized' | 'expired' | 'error';
 export interface ActionCodeMetadata {
     description?: string;
     params?: Record<string, any>;
 }
-export interface ActionCodeTransaction<T> {
-    transaction?: T;
+export interface ActionCodeTransaction {
+    transaction?: string;
     txSignature?: string;
     txType?: string;
 }
-export interface ActionCodeFields<T> {
+export interface ActionCodeFields {
     code: string;
     prefix: string;
     pubkey: string;
     timestamp: number;
     signature: string;
     chain: (typeof SUPPORTED_CHAINS)[number];
-    transaction?: ActionCodeTransaction<T>;
+    transaction?: ActionCodeTransaction;
     metadata?: ActionCodeMetadata;
     expiresAt: number;
     status: ActionCodeStatus;
 }
-export declare class ActionCode<T> {
+export declare class ActionCode {
     private fields;
-    constructor(fields: ActionCodeFields<T>);
-    static fromPayload<T>(input: ActionCodeFields<T>): ActionCode<T>;
-    static fromEncoded<T>(encoded: string): ActionCode<T>;
+    constructor(fields: ActionCodeFields);
+    static fromPayload(input: ActionCodeFields): ActionCode;
+    static fromEncoded(encoded: string): ActionCode;
     get encoded(): string;
-    get isValid(): boolean;
-    get json(): ActionCodeFields<T>;
+    isValid(protocol: ActionCodesProtocol): boolean;
+    get json(): ActionCodeFields;
     /**
      * Get remaining time in milliseconds until expiration
      * @returns Remaining time in milliseconds, or 0 if expired
@@ -68,12 +69,12 @@ export declare class ActionCode<T> {
      * Get the transaction data (chain-specific)
      * @returns Transaction data or undefined
      */
-    get transaction(): ActionCodeTransaction<T> | undefined;
+    get transaction(): ActionCodeTransaction | undefined;
     /**
      * Get metadata associated with this action code
      * @returns Metadata object or undefined
      */
-    get metadata(): ActionCodeFields<T>['metadata'] | undefined;
+    get metadata(): ActionCodeFields['metadata'] | undefined;
     /**
      * Get a human-readable description of the action
      * @returns Description string or undefined

package/dist/actioncode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actioncode.d.ts","sourceRoot":"","sources":["../src/actioncode.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1F,MAAM,WAAW,kBAAkB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,CAAC,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;IACzC,WAAW,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;CAC5B;AAED,qBAAa,UAAU,CAAC,CAAC;IACT,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAE/C,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IAOhE,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;IAKrD,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,OAAO,IAAI,OAAO,CAQrB;IAED,IAAI,IAAI,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAE9B;IAID;;;OAGG;IACH,IAAI,aAAa,IAAI,MAAM,CAG1B;IAED;;;OAGG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;OAGG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;OAGG;IACH,IAAI,MAAM,IAAI,gBAAgB,CAE7B;IAED;;;OAGG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;OAGG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;OAGG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;OAGG;IACH,IAAI,WAAW,IAAI,qBAAqB,CAAC,CAAC,CAAC,GAAG,SAAS,CAEtD;IAED;;;OAGG;IACH,IAAI,QAAQ,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,SAAS,CAE1D;IAED;;;OAGG;IACH,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED;;;OAGG;IACH,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAE5C;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;OAGG;IACH,IAAI,aAAa,IAAI,MAAM,CAO1B;IAED;;;OAGG;IACH,IAAI,mBAAmB,IAAI,MAAM,CAchC;IAED;;;;OAIG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;CACJ"}
+{"version":3,"file":"actioncode.d.ts","sourceRoot":"","sources":["../src/actioncode.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGjD,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1F,MAAM,WAAW,kBAAkB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;IACzC,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;CAC5B;AAED,qBAAa,UAAU;IACP,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,gBAAgB;IAE5C,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU;IAOvD,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU;IAK/C,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,OAAO,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO;IAiB/C,IAAI,IAAI,IAAI,gBAAgB,CAE3B;IAID;;;OAGG;IACH,IAAI,aAAa,IAAI,MAAM,CAG1B;IAED;;;OAGG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;OAGG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;OAGG;IACH,IAAI,MAAM,IAAI,gBAAgB,CAE7B;IAED;;;OAGG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;OAGG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;OAGG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;OAGG;IACH,IAAI,WAAW,IAAI,qBAAqB,GAAG,SAAS,CAEnD;IAED;;;OAGG;IACH,IAAI,QAAQ,IAAI,gBAAgB,CAAC,UAAU,CAAC,GAAG,SAAS,CAEvD;IAED;;;OAGG;IACH,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED;;;OAGG;IACH,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAE5C;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;OAGG;IACH,IAAI,aAAa,IAAI,MAAM,CAO1B;IAED;;;OAGG;IACH,IAAI,mBAAmB,IAAI,MAAM,CAchC;IAED;;;;OAIG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;CACJ"}

package/dist/actioncode.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ActionCode = void 0;
 const codegen_1 = require("./codegen");
+const buffer_1 = require("buffer");
 class ActionCode {
     constructor(fields) {
         this.fields = fields;
@@ -13,14 +14,21 @@ class ActionCode {
         return new ActionCode(input);
     }
     static fromEncoded(encoded) {
-        const decoded = JSON.parse(atob(encoded));
+        const decoded = JSON.parse(buffer_1.Buffer.from(encoded, 'base64').toString('utf8'));
         return ActionCode.fromPayload(decoded);
     }
     get encoded() {
-        return btoa(JSON.stringify(this.fields));
-    }
-    get isValid() {
-        return codegen_1.CodeGenerator.validateCode(this.fields.code, this.fields.pubkey, this.fields.timestamp, this.fields.signature, this.fields.prefix);
+        return buffer_1.Buffer.from(JSON.stringify(this.fields), 'utf8').toString('base64');
+    }
+    isValid(protocol) {
+        if (this.expired)
+            return false;
+        const adapter = protocol.getChainAdapter(this.chain);
+        if (!adapter)
+            throw new Error(`Chain adapter not found for chain ${this.chain}`);
+        const isSignatureValid = adapter.verifyCodeSignature(this);
+        const isCodeValid = codegen_1.CodeGenerator.validateCode(this.fields.code, this.fields.pubkey, this.fields.timestamp, this.fields.prefix);
+        return isSignatureValid && isCodeValid;
     }
     get json() {
         return this.fields;

package/dist/adapters/base.d.ts

@@ -1,3 +1,4 @@
+import { ActionCode } from '../actioncode';
 import { ProtocolMetaV1 } from '../meta';
 /**
  * Base adapter class for chain-specific protocol meta operations
@@ -48,5 +49,21 @@ export declare abstract class BaseChainAdapter<T = any> {
      * @returns True if transaction integrity is valid
      */
     protected abstract validateTransactionIntegrity(tx: T, meta: ProtocolMetaV1): boolean;
+    /**
+     * Get the code signature message
+     * @param code - The code to sign
+     * @param timestamp - The timestamp of the code
+     * @param prefix - The prefix of the code
+     * @returns The code signature message
+     */
+    getCodeSignatureMessage(code: string, timestamp: number, prefix?: string): string;
+    /**
+     * Verify the code signature
+     * This is specific to the chain and should be implemented by the concrete adapter
+     * It will be used to verify the code signature for the action code if the right wallet is used to sign the code
+     * @param actionCode - The action code to verify
+     * @returns True if the code signature is valid
+     */
+    abstract verifyCodeSignature(actionCode: ActionCode): boolean;
 }
 //# 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,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;CACxF"}
+{"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"}

package/dist/adapters/base.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseChainAdapter = void 0;
+const constants_1 = require("../constants");
 /**
  * Base adapter class for chain-specific protocol meta operations
  * @template T - Chain-specific transaction type
@@ -37,5 +38,15 @@ class BaseChainAdapter {
         // Additional chain-specific validation
         return this.validateTransactionIntegrity(tx, meta);
     }
+    /**
+     * Get the code signature message
+     * @param code - The code to sign
+     * @param timestamp - The timestamp of the code
+     * @param prefix - The prefix of the code
+     * @returns The code signature message
+     */
+    getCodeSignatureMessage(code, timestamp, prefix = constants_1.PROTOCOL_CODE_PREFIX) {
+        return `${prefix}:${code}:${timestamp}`;
+    }
 }
 exports.BaseChainAdapter = BaseChainAdapter;

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

@@ -1,6 +1,7 @@
 import { Transaction, TransactionInstruction, VersionedTransaction } from '@solana/web3.js';
 import { ProtocolMetaV1 } from '../../meta';
 import { BaseChainAdapter } from '../base';
+import { ActionCode } from '../../actioncode';
 /**
  * Solana transaction type union
  */
@@ -80,5 +81,6 @@ export declare class SolanaAdapter extends BaseChainAdapter<SolanaTransaction> {
      * @returns True if transaction is valid
      */
     validateFromBase64(base64String: string, authorities: string[], expectedPrefix?: string): boolean;
+    verifyCodeSignature(actionCode: ActionCode): boolean;
 }
 //# 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,EAEvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,cAAc,EAAsB,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C;;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;CAe/G"}
+{"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"}

package/dist/adapters/solana/solana.js

@@ -1,10 +1,45 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SolanaAdapter = void 0;
 const web3_js_1 = require("@solana/web3.js");
 const spl_memo_1 = require("@solana/spl-memo");
 const meta_1 = require("../../meta");
 const base_1 = require("../base");
+const nacl = __importStar(require("tweetnacl"));
+const buffer_1 = require("buffer");
 /**
  * Simple Solana adapter for protocol meta operations
  * Supports both legacy and versioned transactions
@@ -179,7 +214,7 @@ class SolanaAdapter extends base_1.BaseChainAdapter {
      */
     decodeFromBase64(base64String) {
         try {
-            const buffer = Uint8Array.from(atob(base64String), c => c.charCodeAt(0));
+            const buffer = buffer_1.Buffer.from(base64String, 'base64');
             // Try legacy first, then versioned
             try {
                 const transaction = web3_js_1.Transaction.from(buffer);
@@ -203,7 +238,7 @@ class SolanaAdapter extends base_1.BaseChainAdapter {
      */
     validateFromBase64(base64String, authorities, expectedPrefix = 'DEFAULT') {
         try {
-            const buffer = Uint8Array.from(atob(base64String), c => c.charCodeAt(0));
+            const buffer = buffer_1.Buffer.from(base64String, 'base64');
             // Try legacy first, then versioned
             try {
                 const transaction = web3_js_1.Transaction.from(buffer);
@@ -218,6 +253,18 @@ class SolanaAdapter extends base_1.BaseChainAdapter {
             return false;
         }
     }
+    verifyCodeSignature(actionCode) {
+        try {
+            const message = this.getCodeSignatureMessage(actionCode.code, actionCode.timestamp, actionCode.prefix);
+            const messageBytes = new TextEncoder().encode(message);
+            const pubkeyBytes = new web3_js_1.PublicKey(actionCode.pubkey).toBytes();
+            const sigBytes = buffer_1.Buffer.from(actionCode.signature, 'base64');
+            return nacl.sign.detached.verify(messageBytes, sigBytes, pubkeyBytes);
+        }
+        catch (error) {
+            return false;
+        }
+    }
 }
 exports.SolanaAdapter = SolanaAdapter;
 SolanaAdapter.MEMO_PROGRAM_ID = spl_memo_1.MEMO_PROGRAM_ID;

package/dist/codegen.d.ts

@@ -9,6 +9,18 @@ export declare class CodeGenerator {
      * @returns True if prefix is valid, false otherwise
      */
     static validatePrefix(prefix: string): boolean;
+    /**
+     * Validate generated code format
+     * @param code - The code to validate
+     * @returns True if code is valid, false otherwise
+     */
+    static validateCodeFormat(code: string): boolean;
+    /**
+     * Validate that a code without prefix is exactly 8 digits and only numbers
+     * @param code - The code to validate
+     * @returns True if code is valid, false otherwise
+     */
+    static validateCodeDigits(code: string): boolean;
     /**
      * Normalize prefix - convert "DEFAULT" to empty string, validate others
      * @param prefix - The prefix to normalize
@@ -19,12 +31,12 @@ export declare class CodeGenerator {
     /**
      * Generate a deterministic 8-digit code based on public key, prefix, and timestamp
      * @param pubkey - Solana wallet public key (base58)
-     * @param signature - User's signature string
      * @param prefix - Optional namespace prefix (default: "DEFAULT")
      * @param timestamp - UNIX timestamp in milliseconds (defaults to now)
      * @returns Object containing code, issuedAt, and expiresAt timestamps
+     * @throws Error if generated code is invalid
      */
-    static generateCode(pubkey: string, signature: string, prefix?: string, timestamp?: number): {
+    static generateCode(pubkey: string, prefix?: string, timestamp?: number): {
         code: string;
         issuedAt: number;
         expiresAt: number;
@@ -37,32 +49,23 @@ export declare class CodeGenerator {
      * @returns Full SHA-256 hash string
      */
     static deriveCodeHash(pubkey: string, prefix?: string, timestamp?: number): string;
-    /**
-     * Generate the message that should be signed for code verification
-     * @param code - The generated 8-digit code
-     * @param timestamp - UNIX timestamp in milliseconds
-     * @returns Message string in format "actioncodes:<code>:<timestamp>"
-     */
-    static generateCodeSignatureMessage(code: string, timestamp: number): string;
     /**
      * Get the expected code for a given public key and timestamp
      * @param pubkey - Solana wallet public key (base58)
      * @param timestamp - UNIX timestamp in milliseconds
-     * @param signature - User's signature string
      * @param prefix - Optional namespace prefix (default: "DEFAULT")
      * @returns 8-digit numeric string
      */
-    static getExpectedCode(pubkey: string, timestamp: number, signature: string, prefix?: string): string;
+    static getExpectedCode(pubkey: string, timestamp: number, prefix?: string): string;
     /**
      * Validate if a code matches the expected code for a given public key and timestamp
      * @param code - The code to validate
      * @param pubkey - Solana wallet public key (base58)
      * @param timestamp - UNIX timestamp in milliseconds
-     * @param signature - User's signature string
      * @param prefix - Optional namespace prefix (default: "DEFAULT")
      * @returns True if code matches expected code and timestamp is valid
      */
-    static validateCode(code: string, pubkey: string, timestamp: number, signature: string, prefix?: string): boolean;
+    static validateCode(code: string, pubkey: string, timestamp: number, prefix?: string): boolean;
     /**
      * Check if a timestamp falls within a valid time window
      * @param timestamp - UNIX timestamp in milliseconds

package/dist/codegen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"AAGA,qBAAa,aAAa;IACtB,MAAM,CAAC,cAAc,SAAY;IACjC,MAAM,CAAC,WAAW,SAAe;IACjC,MAAM,CAAC,iBAAiB,SAAqB;IAC7C,MAAM,CAAC,iBAAiB,SAAqB;IAE7C;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAM9C;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAQ9C;;;;;;;OAOG;IACH,MAAM,CAAC,YAAY,CACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,MAAkB,EAC1B,SAAS,GAAE,MAAmB,GAC/B;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAmBxD;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CACjB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAkB,EAC1B,SAAS,CAAC,EAAE,MAAM,GACnB,MAAM;IAQT;;;;;OAKG;IACH,MAAM,CAAC,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAI5E;;;;;;;OAOG;IACH,MAAM,CAAC,eAAe,CAClB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,MAAkB,GAC3B,MAAM;IAIT;;;;;;;;OAQG;IACH,MAAM,CAAC,YAAY,CACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,MAAkB,GAC3B,OAAO;IAOV;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;CAGtD"}
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"AAGA,qBAAa,aAAa;IACtB,MAAM,CAAC,cAAc,SAAY;IACjC,MAAM,CAAC,WAAW,SAAe;IACjC,MAAM,CAAC,iBAAiB,SAAqB;IAC7C,MAAM,CAAC,iBAAiB,SAAqB;IAE7C;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAM9C;;;;OAIG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAMhD;;;;OAIG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAMhD;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAQ9C;;;;;;;OAOG;IACH,MAAM,CAAC,YAAY,CACf,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAkB,EAC1B,SAAS,GAAE,MAAmB,GAC/B;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IA8BxD;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CACjB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAkB,EAC1B,SAAS,CAAC,EAAE,MAAM,GACnB,MAAM;IAQT;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,CAClB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,MAAkB,GAC3B,MAAM;IAIT;;;;;;;OAOG;IACH,MAAM,CAAC,YAAY,CACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,MAAkB,GAC3B,OAAO;IAgBV;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;CAGtD"}

package/dist/codegen.js

@@ -16,6 +16,30 @@ class CodeGenerator {
             return false;
         return /^[A-Za-z]+$/.test(prefix);
     }
+    /**
+     * Validate generated code format
+     * @param code - The code to validate
+     * @returns True if code is valid, false otherwise
+     */
+    static validateCodeFormat(code) {
+        if (!code || typeof code !== 'string')
+            return false;
+        if (code.length !== this.CODE_DIGITS)
+            return false;
+        return /^\d+$/.test(code);
+    }
+    /**
+     * Validate that a code without prefix is exactly 8 digits and only numbers
+     * @param code - The code to validate
+     * @returns True if code is valid, false otherwise
+     */
+    static validateCodeDigits(code) {
+        if (!code || typeof code !== 'string')
+            return false;
+        if (code.length !== constants_1.CODE_LENGTH)
+            return false;
+        return /^[0-9]{8}$/.test(code);
+    }
     /**
      * Normalize prefix - convert "DEFAULT" to empty string, validate others
      * @param prefix - The prefix to normalize
@@ -33,22 +57,30 @@ class CodeGenerator {
     /**
      * Generate a deterministic 8-digit code based on public key, prefix, and timestamp
      * @param pubkey - Solana wallet public key (base58)
-     * @param signature - User's signature string
      * @param prefix - Optional namespace prefix (default: "DEFAULT")
      * @param timestamp - UNIX timestamp in milliseconds (defaults to now)
      * @returns Object containing code, issuedAt, and expiresAt timestamps
+     * @throws Error if generated code is invalid
      */
-    static generateCode(pubkey, signature, prefix = "DEFAULT", timestamp = Date.now()) {
+    static generateCode(pubkey, prefix = "DEFAULT", timestamp = Date.now()) {
         const normalizedPrefix = this.normalizePrefix(prefix);
-        const input = `${normalizedPrefix}:${pubkey}:${timestamp}:${signature}`;
+        const input = `${normalizedPrefix}:${pubkey}:${timestamp}`;
         const hash = (0, js_sha256_1.sha256)(input);
         const raw = parseInt(hash.slice(0, 16), 16);
         const mod = 10 ** this.CODE_DIGITS;
         const code = raw % mod;
         const issuedAt = timestamp;
         const expiresAt = issuedAt + this.TIME_WINDOW_MS;
+        const generatedCode = code.toString().padStart(this.CODE_DIGITS, "0");
+        // Validate the generated code
+        if (!this.validateCodeFormat(generatedCode)) {
+            throw new Error(`Generated code validation failed: ${generatedCode}`);
+        }
+        if (!this.validateCodeDigits(generatedCode)) {
+            throw new Error(`Generated code must be exactly 8 digits: ${generatedCode}`);
+        }
         return {
-            code: code.toString().padStart(this.CODE_DIGITS, "0"),
+            code: generatedCode,
             issuedAt,
             expiresAt
         };
@@ -67,37 +99,33 @@ class CodeGenerator {
         const hash = (0, js_sha256_1.sha256)(input);
         return hash;
     }
-    /**
-     * Generate the message that should be signed for code verification
-     * @param code - The generated 8-digit code
-     * @param timestamp - UNIX timestamp in milliseconds
-     * @returns Message string in format "actioncodes:<code>:<timestamp>"
-     */
-    static generateCodeSignatureMessage(code, timestamp) {
-        return `${constants_1.PROTOCOL_PREFIX}:${code}:${timestamp}`;
-    }
     /**
      * Get the expected code for a given public key and timestamp
      * @param pubkey - Solana wallet public key (base58)
      * @param timestamp - UNIX timestamp in milliseconds
-     * @param signature - User's signature string
      * @param prefix - Optional namespace prefix (default: "DEFAULT")
      * @returns 8-digit numeric string
      */
-    static getExpectedCode(pubkey, timestamp, signature, prefix = "DEFAULT") {
-        return this.generateCode(pubkey, signature, prefix, timestamp).code;
+    static getExpectedCode(pubkey, timestamp, prefix = "DEFAULT") {
+        return this.generateCode(pubkey, prefix, timestamp).code;
     }
     /**
      * Validate if a code matches the expected code for a given public key and timestamp
      * @param code - The code to validate
      * @param pubkey - Solana wallet public key (base58)
      * @param timestamp - UNIX timestamp in milliseconds
-     * @param signature - User's signature string
      * @param prefix - Optional namespace prefix (default: "DEFAULT")
      * @returns True if code matches expected code and timestamp is valid
      */
-    static validateCode(code, pubkey, timestamp, signature, prefix = "DEFAULT") {
-        const expectedCode = this.getExpectedCode(pubkey, timestamp, signature, prefix);
+    static validateCode(code, pubkey, timestamp, prefix = "DEFAULT") {
+        // First validate the code format
+        if (!this.validateCodeFormat(code)) {
+            return false;
+        }
+        if (!this.validateCodeDigits(code)) {
+            return false;
+        }
+        const expectedCode = this.getExpectedCode(pubkey, timestamp, prefix);
         const now = Date.now();
         const isTimeValid = timestamp >= 0 && timestamp <= now && now <= timestamp + this.TIME_WINDOW_MS;
         return code === expectedCode && isTimeValid;

package/dist/protocol.d.ts

@@ -51,22 +51,22 @@ export declare class ActionCodesProtocol {
      * @returns Chain adapter or undefined
      */
     getChainAdapter<T = any>(chain: string): BaseChainAdapter<T> | undefined;
-    /**
-     * Generate an action code for a specific chain
-     * @param pubkey - User's public key
-     * @param signature - User's signature
-     * @param chain - Target chain
-     * @param prefix - Optional prefix (defaults to config defaultPrefix)
-     * @param timestamp - Optional timestamp (defaults to now)
-     * @returns ActionCode object
-     */
-    generateActionCode(pubkey: string, signature: string, chain: SupportedChain, prefix?: string, timestamp?: number): ActionCode<string>;
     /**
      * Validate an action code
      * @param actionCode - ActionCode to validate
      * @returns True if valid
      */
-    validateActionCode(actionCode: ActionCode<string>): boolean;
+    validateActionCode(actionCode: ActionCode): boolean;
+    /**
+     * Create an action code
+     * @param pubkey - Wallet public key
+     * @param signFn - Chain-specific signing function (e.g.wallet.signMessage)
+     * @param chain - Target blockchain
+     * @param prefix - Optional code prefix
+     * @param timestamp - Optional timestamp
+     * @returns Promise resolving to a complete ActionCode object
+     */
+    createActionCode(pubkey: string, signFn: (message: string) => Promise<string>, chain: SupportedChain, prefix?: string, timestamp?: number): Promise<ActionCode>;
     /**
      * Attach a transaction to an action code
      * @param actionCode - ActionCode to attach transaction to
@@ -74,14 +74,14 @@ export declare class ActionCodesProtocol {
      * @param txType - Optional transaction type
      * @returns Updated ActionCode
      */
-    attachTransaction(actionCode: ActionCode<string>, transaction: string, txType?: string): ActionCode<string>;
+    attachTransaction(actionCode: ActionCode, transaction: string, txType?: string): ActionCode;
     /**
      * Finalize an action code with transaction signature
      * @param actionCode - ActionCode to finalize
      * @param txSignature - Transaction signature
      * @returns Updated ActionCode
      */
-    finalizeActionCode(actionCode: ActionCode<string>, txSignature: string): ActionCode<string>;
+    finalizeActionCode(actionCode: ActionCode, txSignature: string): ActionCode;
     /**
      * Create protocol meta for a transaction
      * @param actionCode - ActionCode to create meta for
@@ -89,7 +89,7 @@ export declare class ActionCodesProtocol {
      * @param params - Optional parameters
      * @returns ProtocolMetaV1 object
      */
-    createProtocolMeta(actionCode: ActionCode<string>, issuer?: string, params?: string): ProtocolMetaV1;
+    createProtocolMeta(actionCode: ActionCode, issuer?: string, params?: string): ProtocolMetaV1;
     /**
      * Encode protocol meta for a specific chain
      * @param meta - ProtocolMetaV1 object

package/dist/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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"}

package/dist/protocol.js

@@ -54,36 +54,6 @@ class ActionCodesProtocol {
     getChainAdapter(chain) {
         return this.adapters.get(chain);
     }
-    /**
-     * Generate an action code for a specific chain
-     * @param pubkey - User's public key
-     * @param signature - User's signature
-     * @param chain - Target chain
-     * @param prefix - Optional prefix (defaults to config defaultPrefix)
-     * @param timestamp - Optional timestamp (defaults to now)
-     * @returns ActionCode object
-     */
-    generateActionCode(pubkey, signature, chain, prefix, timestamp) {
-        if (!this.isChainSupported(chain)) {
-            throw new Error(`Chain '${chain}' is not supported. Registered chains: ${this.getRegisteredChains().join(', ')}`);
-        }
-        const normalizedPrefix = prefix || this.config.defaultPrefix;
-        const ts = timestamp || Date.now();
-        // Generate code using CodeGenerator
-        const { code, issuedAt, expiresAt } = codegen_1.CodeGenerator.generateCode(pubkey, signature, normalizedPrefix, ts);
-        // Create ActionCode object
-        const actionCodeFields = {
-            code,
-            prefix: normalizedPrefix,
-            pubkey,
-            timestamp: issuedAt,
-            signature,
-            chain,
-            expiresAt,
-            status: 'pending'
-        };
-        return actioncode_1.ActionCode.fromPayload(actionCodeFields);
-    }
     /**
      * Validate an action code
      * @param actionCode - ActionCode to validate
@@ -101,6 +71,45 @@ class ActionCodesProtocol {
         // Chain-specific validation would be done when attaching transactions
         return true;
     }
+    /**
+     * Create an action code
+     * @param pubkey - Wallet public key
+     * @param signFn - Chain-specific signing function (e.g.wallet.signMessage)
+     * @param chain - Target blockchain
+     * @param prefix - Optional code prefix
+     * @param timestamp - Optional timestamp
+     * @returns Promise resolving to a complete ActionCode object
+     */
+    async createActionCode(pubkey, signFn, chain, prefix = this.config.defaultPrefix, timestamp) {
+        if (!this.isChainSupported(chain)) {
+            throw new Error(`Chain '${chain}' is not supported. Registered chains: ${this.getRegisteredChains().join(', ')}`);
+        }
+        const adapter = this.getChainAdapter(chain);
+        if (!adapter) {
+            throw new Error(`No adapter found for chain '${chain}'`);
+        }
+        const ts = timestamp || Date.now();
+        const { code, issuedAt, expiresAt } = codegen_1.CodeGenerator.generateCode(pubkey, prefix, ts);
+        const message = adapter.getCodeSignatureMessage(code, issuedAt, prefix);
+        const signature = await signFn(message);
+        const actionCode = actioncode_1.ActionCode.fromPayload({
+            code,
+            pubkey,
+            signature,
+            timestamp: issuedAt,
+            expiresAt,
+            prefix,
+            chain,
+            status: 'pending'
+        });
+        if (!this.validateActionCode(actionCode)) {
+            throw new Error('Invalid action code');
+        }
+        if (!adapter.verifyCodeSignature(actionCode)) {
+            throw new Error('Invalid signature for generated code');
+        }
+        return actionCode;
+    }
     /**
      * Attach a transaction to an action code
      * @param actionCode - ActionCode to attach transaction to

package/docs/README.md

@@ -4,7 +4,7 @@
 
 # 🛡️ Action Codes Protocol
 
-![Coverage](https://img.shields.io/badge/coverage-99.25%25-brightgreen)
+![Coverage](https://img.shields.io/badge/coverage-98%-brightgreen)
 
 **Action Codes Protocol** enables short-lived, cryptographically verifiable action codes that authorize blockchain transactions and intents without requiring live wallet sessions.