@pushchain/core 0.1.20 → 0.1.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pushchain/core",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "dependencies": {
     "@bufbuild/protobuf": "^2.0.0",
     "@coral-xyz/anchor": "^0.31.0",

package/src/lib/constants/index.d.ts

@@ -10,6 +10,7 @@ export declare const CONSTANTS: {
                 readonly url: "https://explorer.testnet.push.org/";
             };
         };
+        blockTime?: number | undefined;
         contracts?: import("viem").Prettify<{
             [key: string]: import("viem").ChainContract | {
                 [sourceId: number]: import("viem").ChainContract | undefined;

package/src/lib/constants/viem-push-testnet.d.ts

@@ -6,6 +6,7 @@ export declare const VIEM_PUSH_TESTNET_DONUT: {
             readonly url: "https://explorer.testnet.push.org/";
         };
     };
+    blockTime?: number | undefined;
     contracts?: viem.Prettify<{
         [key: string]: viem.ChainContract | {
             [sourceId: number]: viem.ChainContract | undefined;

package/src/lib/pushChain.d.ts

@@ -12,6 +12,7 @@ import { TypedData, TypedDataDomain } from 'viem';
 export declare class PushChain {
     private orchestrator;
     private universalSigner;
+    private blockExplorers;
     /**
      * @static
      * Constants for the PushChain SDK.
@@ -26,6 +27,7 @@ export declare class PushChain {
                     readonly url: "https://explorer.testnet.push.org/";
                 };
             };
+            blockTime?: number | undefined;
             contracts?: import("viem").Prettify<{
                 [key: string]: import("viem").ChainContract | {
                     [sourceId: number]: import("viem").ChainContract | undefined;
@@ -34,9 +36,7 @@ export declare class PushChain {
                 ensRegistry?: import("viem").ChainContract | undefined;
                 ensUniversalResolver?: import("viem").ChainContract | undefined;
                 multicall3?: import("viem").ChainContract | undefined;
-                universalSignatureVerifier? /**
-                 * Signs an arbitrary message
-                 */: import("viem").ChainContract | undefined;
+                universalSignatureVerifier?: import("viem").ChainContract | undefined;
             }> | undefined;
             ensTlds?: readonly string[] | undefined;
             id: number;
@@ -89,6 +89,9 @@ export declare class PushChain {
             message: Record<string, any>;
         }) => Promise<string>;
     };
+    explorer: {
+        getTransactionUrl: (txHash: string) => string;
+    };
     private constructor();
     /**
      * @method initialize

package/src/lib/pushChain.js

@@ -18,9 +18,10 @@ const viem_1 = require("viem");
  * Provides access to cross-chain execution, utilities, and signer abstraction.
  */
 class PushChain {
-    constructor(orchestrator, universalSigner) {
+    constructor(orchestrator, universalSigner, blockExplorers) {
         this.orchestrator = orchestrator;
         this.universalSigner = universalSigner;
+        this.blockExplorers = blockExplorers;
         this.orchestrator = orchestrator;
         this.universal = {
             get origin() {
@@ -49,6 +50,11 @@ class PushChain {
                 return (0, viem_1.bytesToHex)(signBytes);
             }),
         };
+        this.explorer = {
+            getTransactionUrl: (txHash) => {
+                return `https://donut.push.network/tx/${txHash}`;
+            },
+        };
     }
 }
 exports.PushChain = PushChain;
@@ -76,13 +82,18 @@ PushChain.utils = utils_1.Utils;
  * @returns An initialized instance of PushChain.
  */
 PushChain.initialize = (universalSigner, options) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
-    var _b, _c, _d;
+    var _b, _c, _d, _e;
     const validatedUniversalSigner = (0, signer_1.createUniversalSigner)(universalSigner);
+    const blockExplorers = (_b = options === null || options === void 0 ? void 0 : options.blockExplorers) !== null && _b !== void 0 ? _b : {
+        [enums_1.CHAIN.PUSH_TESTNET_DONUT]: {
+            default: 'https://donut.push.network',
+        },
+    };
     const orchestrator = new orchestrator_1.Orchestrator(
     /**
      * Ensures the signer conforms to the UniversalSigner interface.
      */
-    validatedUniversalSigner, (_b = options === null || options === void 0 ? void 0 : options.network) !== null && _b !== void 0 ? _b : enums_1.PUSH_NETWORK.TESTNET_DONUT, (_c = options === null || options === void 0 ? void 0 : options.rpcUrls) !== null && _c !== void 0 ? _c : {}, (_d = options === null || options === void 0 ? void 0 : options.printTraces) !== null && _d !== void 0 ? _d : false);
-    return new _a(orchestrator, validatedUniversalSigner);
+    validatedUniversalSigner, (_c = options === null || options === void 0 ? void 0 : options.network) !== null && _c !== void 0 ? _c : enums_1.PUSH_NETWORK.TESTNET_DONUT, (_d = options === null || options === void 0 ? void 0 : options.rpcUrls) !== null && _d !== void 0 ? _d : {}, (_e = options === null || options === void 0 ? void 0 : options.printTraces) !== null && _e !== void 0 ? _e : false);
+    return new _a(orchestrator, validatedUniversalSigner, blockExplorers);
 });
 //# sourceMappingURL=pushChain.js.map

package/src/lib/pushChain.js.map

@@ -1 +1 @@
-{"version":3,"file":"pushChain.js","sourceRoot":"","sources":["../../../../../packages/core/src/lib/pushChain.ts"],"names":[],"mappings":";;;;;AAAA,2CAAwC;AACxC,6CAA4D;AAC5D,6CAA+C;AAC/C,8DAA2D;AAC3D,+CAA2D;AAE3D,mCAAgC;AAChC,wDAAwB;AACxB,+BAA8D;AAE9D;;;;;GAKG;AACH,MAAa,SAAS;IA6CpB,YACU,YAA0B,EAC1B,eAAgC;QADhC,iBAAY,GAAZ,YAAY,CAAc;QAC1B,oBAAe,GAAf,eAAe,CAAiB;QAExC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QAEjC,IAAI,CAAC,SAAS,GAAG;YACf,IAAI,MAAM;gBACR,OAAO,YAAY,CAAC,MAAM,EAAE,CAAC;YAC/B,CAAC;YACD,IAAI,OAAO;gBACT,OAAO,YAAY,CAAC,kBAAkB,EAAE,CAAC;YAC3C,CAAC;YACD,eAAe,EAAE,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC;YACxD,WAAW,EAAE,CAAO,IAAgB,EAAE,EAAE;gBACtC,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBACzD,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC;gBAC5C,IAAI,kBAAU,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,UAAE,CAAC,GAAG,EAAE,CAAC;oBACpC,OAAO,IAAA,iBAAU,EAAC,QAAQ,CAAC,CAAC;gBAC9B,CAAC;qBAAM,IAAI,kBAAU,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,UAAE,CAAC,GAAG,EAAE,CAAC;oBAC3C,OAAO,cAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC/B,CAAC;gBACD,OAAO,IAAA,iBAAU,EAAC,QAAQ,CAAC,CAAC;YAC9B,CAAC,CAAA;YACD,aAAa,EAAE,CAAO,GAAG,IAAI,EAAE,EAAE;gBAC/B,IAAI,OAAO,eAAe,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;oBACxD,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;gBACtD,CAAC;gBACD,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,CAAC;gBAC/D,OAAO,IAAA,iBAAU,EAAC,SAAS,CAAC,CAAC;YAC/B,CAAC,CAAA;SACF,CAAC;IACJ,CAAC;;AA7EH,8BAiHC;;AAhHC;;;GAGG;AACW,mBAAS,GAAG,qBAAS,AAAZ,CAAa;AAEpC;;;GAGG;AACW,eAAK,GAAG,aAAK,AAAR,CAAS;AAoE5B;;;;;;;;;;;GAWG;AACI,oBAAU,GAAG,CAClB,eAAgC,EAChC,OAMC,EACmB,EAAE;;IACtB,MAAM,wBAAwB,GAAG,IAAA,8BAAqB,EAAC,eAAe,CAAC,CAAC;IACxE,MAAM,YAAY,GAAG,IAAI,2BAAY;IACnC;;OAEG;IACH,wBAAwB,EACxB,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,mCAAI,oBAAY,CAAC,aAAa,EAC9C,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,mCAAI,EAAE,EACtB,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW,mCAAI,KAAK,CAC9B,CAAC;IACF,OAAO,IAAI,EAAS,CAAC,YAAY,EAAE,wBAAwB,CAAC,CAAC;AAC/D,CAAC,CAAA,AArBgB,CAqBf"}
+{"version":3,"file":"pushChain.js","sourceRoot":"","sources":["../../../../../packages/core/src/lib/pushChain.ts"],"names":[],"mappings":"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"}

package/src/lib/universal/signer/signer.d.ts

@@ -31,7 +31,7 @@ export declare function createUniversalSigner({ account, signMessage, signAndSen
  * @param {CHAIN} chain - The chain the signer will operate on
  * @returns {Promise<UniversalSigner>} A signer object configured for the specified chain
  */
-export declare function toUniversalFromKeyPair(clientOrAccount: WalletClient | Keypair | ethers.Wallet | ethers.HDNodeWallet, { chain, library }: {
+export declare function toUniversalFromKeypair(clientOrAccount: WalletClient | Keypair | ethers.Wallet | ethers.HDNodeWallet, { chain, library }: {
     chain: CHAIN;
     library: LIBRARY;
 }): Promise<UniversalSigner>;

package/src/lib/universal/signer/signer.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createUniversalSigner = createUniversalSigner;
-exports.toUniversalFromKeyPair = toUniversalFromKeyPair;
+exports.toUniversalFromKeypair = toUniversalFromKeypair;
 exports.construct = construct;
 exports.toUniversal = toUniversal;
 const tslib_1 = require("tslib");
@@ -46,7 +46,7 @@ function createUniversalSigner({ account, signMessage, signAndSendTransaction, s
  * @param {CHAIN} chain - The chain the signer will operate on
  * @returns {Promise<UniversalSigner>} A signer object configured for the specified chain
  */
-function toUniversalFromKeyPair(clientOrAccount_1, _a) {
+function toUniversalFromKeypair(clientOrAccount_1, _a) {
     return tslib_1.__awaiter(this, arguments, void 0, function* (clientOrAccount, { chain, library }) {
         let address;
         let signMessage;

package/src/lib/utils.d.ts

@@ -1,5 +1,5 @@
 import { convertOriginToExecutor, fromChainAgnostic, toChainAgnostic, toUniversal } from './universal/account';
-import { toUniversalFromKeyPair, construct, toUniversal as toUniversalSigner } from './universal/signer';
+import { construct, toUniversal as toUniversalSigner, toUniversalFromKeypair } from './universal/signer';
 /**
  * @dev - THESE UTILS ARE EXPORTED TO SDK CONSUMER
  * @dev - Make sure each exported fn has good comments to help out sdk consumer
@@ -46,7 +46,7 @@ export declare class Utils {
         /**
          * Converts various signer types (viem, ethers v6, Solana) into a UniversalSigner.
          */
-        toUniversalFromKeyPair: typeof toUniversalFromKeyPair;
+        toUniversalFromKeypair: typeof toUniversalFromKeypair;
         /**
          * Constructs a UniversalSignerSkeleton from raw signing functions.
          */
@@ -56,4 +56,7 @@ export declare class Utils {
          */
         toUniversal: typeof toUniversalSigner;
     };
+    static helpers: {
+        getChainName: (chainNamespace: string) => string;
+    };
 }

package/src/lib/utils.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Utils = void 0;
 const account_1 = require("./universal/account");
 const signer_1 = require("./universal/signer");
+const enums_1 = require("./constants/enums");
 /**
  * @dev - THESE UTILS ARE EXPORTED TO SDK CONSUMER
  * @dev - Make sure each exported fn has good comments to help out sdk consumer
@@ -51,7 +52,7 @@ Utils.signer = {
     /**
      * Converts various signer types (viem, ethers v6, Solana) into a UniversalSigner.
      */
-    toUniversalFromKeyPair: signer_1.toUniversalFromKeyPair,
+    toUniversalFromKeypair: signer_1.toUniversalFromKeypair,
     /**
      * Constructs a UniversalSignerSkeleton from raw signing functions.
      */
@@ -61,4 +62,14 @@ Utils.signer = {
      */
     toUniversal: signer_1.toUniversal,
 };
+Utils.helpers = {
+    getChainName: (chainNamespace) => {
+        const chainEntries = Object.entries(enums_1.CHAIN);
+        const foundEntry = chainEntries.find(([_, value]) => value === chainNamespace);
+        if (!foundEntry) {
+            throw new Error(`Chain value '${chainNamespace}' not found in CHAIN enum`);
+        }
+        return foundEntry[0];
+    },
+};
 //# sourceMappingURL=utils.js.map

package/src/lib/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../packages/core/src/lib/utils.ts"],"names":[],"mappings":";;;AAAA,iDAK6B;AAC7B,+CAI4B;AAE5B;;;GAGG;AAEH;;;GAGG;AACH,MAAa,KAAK;;AAAlB,sBAoDC;AAnDQ,aAAO,GAAG;IACf;;;;;;;;;;;;;;;OAeG;IACH,eAAe,EAAf,yBAAe;IAEf,WAAW,EAAX,qBAAW;IAEX;;;;;;;;;;OAUG;IACH,iBAAiB,EAAjB,2BAAiB;IAEjB,uBAAuB,EAAvB,iCAAuB;CACxB,CAAC;AAEK,YAAM,GAAG;IACd;;OAEG;IACH,sBAAsB,EAAtB,+BAAsB;IACtB;;OAEG;IACH,SAAS,EAAT,kBAAS;IACT;;OAEG;IACH,WAAW,EAAE,oBAAiB;CAC/B,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../packages/core/src/lib/utils.ts"],"names":[],"mappings":";;;AAAA,iDAK6B;AAC7B,+CAI4B;AAC5B,6CAA0C;AAE1C;;;GAGG;AAEH;;;GAGG;AACH,MAAa,KAAK;;AAAlB,sBAqEC;AApEQ,aAAO,GAAG;IACf;;;;;;;;;;;;;;;OAeG;IACH,eAAe,EAAf,yBAAe;IAEf,WAAW,EAAX,qBAAW;IAEX;;;;;;;;;;OAUG;IACH,iBAAiB,EAAjB,2BAAiB;IAEjB,uBAAuB,EAAvB,iCAAuB;CACxB,CAAC;AAEK,YAAM,GAAG;IACd;;OAEG;IACH,sBAAsB,EAAtB,+BAAsB;IACtB;;OAEG;IACH,SAAS,EAAT,kBAAS;IACT;;OAEG;IACH,WAAW,EAAE,oBAAiB;CAC/B,CAAC;AAEK,aAAO,GAAG;IACf,YAAY,EAAE,CAAC,cAAsB,EAAE,EAAE;QACvC,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,aAAK,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAClC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,cAAc,CACzC,CAAC;QAEF,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,gBAAgB,cAAc,2BAA2B,CAC1D,CAAC;QACJ,CAAC;QAED,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;CACF,CAAC"}