@startbahn/startrail-sdk-js 1.34.0 → 1.35.0

package/README.md

@@ -42,8 +42,8 @@ const startrail = new Startrail(params)
     - `startrail`: Google or Email/Passord powered by TORUS.
   - `env` (optional): Environment that impacts on blockchain network, and EOA with startrail Email/Password
     - `production`: Matic network. TORUS production account and Startrail production Auth0 account. It is designed to communicate to Startrail production API.
-    - `staging`: Mumbai network. TORUS production account and Startrail staging Auth0 account. It is designed to communicate to Startrail staging API.
-    - `lrc`: Mumbai network. TORUS lrc account and Startrail qa Auth0 account. It is designed to communicate to Startrail qa API.
+    - `staging`: Amoy network. TORUS production account and Startrail staging Auth0 account. It is designed to communicate to Startrail staging API.
+    - `lrc`: Amoy network. TORUS lrc account and Startrail qa Auth0 account. It is designed to communicate to Startrail qa API.
     - `local`: https://localhost:8545 network for local dev. TORUS lrc account and Startrail lrc Auth0 account. It is designed to communicate to localhost API.
 
 [For Startrail wallet powered  by TORUS]
@@ -70,6 +70,7 @@ const startrail = new Startrail(params)
   - `callbackUrl` (optional): Callback URL to redirect to from E-Mail template for signup verification
   - `withModal` (optional): Specifies if the Torus Login Provider Modal should be shown. Default value is set to `false`
   - `rpcEndpoint` (optional): RpcEndpoint that is accessed from the wallet you login/signup
+  - `chainId` (optional): chainId of EVM based blockchain that is accessed from the wallet you login/signup
   
 [To be deprecate]
   - `torusBuildEnv` (optional): Alias for `env`.

package/dist/startrail-sdk.js

@@ -10479,6 +10479,7 @@ module.exports["default"] = AbortController
 /***/ ((module, __unused_webpack_exports, __webpack_require__) => {
 
 "use strict";
+/* provided dependency */ var process = __webpack_require__(4155);
 // Currently in sync with Node.js lib/assert.js
 // https://github.com/nodejs/node/commit/2a51ae424a513ec9a6aa3466baa0cc1d55dd4f3b
 
@@ -11076,6 +11077,7 @@ assert.strict.strict = assert.strict;
 /***/ ((module, __unused_webpack_exports, __webpack_require__) => {
 
 "use strict";
+/* provided dependency */ var process = __webpack_require__(4155);
 // Currently in sync with Node.js lib/internal/assert/assertion_error.js
 // https://github.com/nodejs/node/commit/0817840f775032169ddd70c85ac059f18ffcc81c
 
@@ -16048,6 +16050,7 @@ if (typeof self === 'object') {
 
 "use strict";
 /* provided dependency */ var Buffer = __webpack_require__(8764)["Buffer"];
+/* provided dependency */ var process = __webpack_require__(4155);
 
 /* eslint camelcase: "off" */
 
@@ -16464,6 +16467,7 @@ exports.Zlib = Zlib;
 /***/ ((__unused_webpack_module, exports, __webpack_require__) => {
 
 "use strict";
+/* provided dependency */ var process = __webpack_require__(4155);
 
 
 var Buffer = (__webpack_require__(8764).Buffer);
@@ -23523,6 +23527,7 @@ utils.intFromLE = intFromLE;
 /***/ 2840:
 /***/ ((module, __unused_webpack_exports, __webpack_require__) => {
 
+/* provided dependency */ var process = __webpack_require__(4155);
 var once = __webpack_require__(778);
 
 var noop = function() {};
@@ -42229,6 +42234,7 @@ process.umask = function() { return 0; };
 /***/ 4286:
 /***/ ((module, __unused_webpack_exports, __webpack_require__) => {
 
+/* provided dependency */ var process = __webpack_require__(4155);
 var once = __webpack_require__(778)
 var eos = __webpack_require__(2840)
 var fs = __webpack_require__(1156) // we only need fs to get the ReadStream and WriteStream prototypes
@@ -42319,6 +42325,7 @@ module.exports = pump
 /***/ ((module, __unused_webpack_exports, __webpack_require__) => {
 
 "use strict";
+/* provided dependency */ var process = __webpack_require__(4155);
 
 
 // limit of Crypto.getRandomValues()
@@ -42512,6 +42519,7 @@ module.exports.q = codes;
 /***/ ((module, __unused_webpack_exports, __webpack_require__) => {
 
 "use strict";
+/* provided dependency */ var process = __webpack_require__(4155);
 // Copyright Joyent, Inc. and other Node contributors.
 //
 // Permission is hereby granted, free of charge, to any person obtaining a
@@ -42689,6 +42697,7 @@ PassThrough.prototype._transform = function (chunk, encoding, cb) {
 /***/ ((module, __unused_webpack_exports, __webpack_require__) => {
 
 "use strict";
+/* provided dependency */ var process = __webpack_require__(4155);
 // Copyright Joyent, Inc. and other Node contributors.
 //
 // Permission is hereby granted, free of charge, to any person obtaining a
@@ -43920,6 +43929,7 @@ function done(stream, er, data) {
 /***/ ((module, __unused_webpack_exports, __webpack_require__) => {
 
 "use strict";
+/* provided dependency */ var process = __webpack_require__(4155);
 // Copyright Joyent, Inc. and other Node contributors.
 //
 // Permission is hereby granted, free of charge, to any person obtaining a
@@ -44568,6 +44578,7 @@ Writable.prototype._destroy = function (err, cb) {
 /***/ ((module, __unused_webpack_exports, __webpack_require__) => {
 
 "use strict";
+/* provided dependency */ var process = __webpack_require__(4155);
 
 
 var _Object$setPrototypeO;
@@ -44942,9 +44953,10 @@ module.exports = /*#__PURE__*/function () {
 /***/ }),
 
 /***/ 1195:
-/***/ ((module) => {
+/***/ ((module, __unused_webpack_exports, __webpack_require__) => {
 
 "use strict";
+/* provided dependency */ var process = __webpack_require__(4155);
 
 
 // undocumented cb() API, needed for core, not for public API
@@ -51831,6 +51843,7 @@ exports.isAnyArrayBuffer = isAnyArrayBuffer;
 /***/ 9539:
 /***/ ((__unused_webpack_module, exports, __webpack_require__) => {
 
+/* provided dependency */ var process = __webpack_require__(4155);
 // Copyright Joyent, Inc. and other Node contributors.
 //
 // Permission is hereby granted, free of charge, to any person obtaining a
@@ -52888,6 +52901,7 @@ __webpack_require__.r(__webpack_exports__);
 // EXPORTS
 __webpack_require__.d(__webpack_exports__, {
   Auth0VerifyEmail: () => (/* reexport */ Auth0VerifyEmail),
+  JSON_RPC_ERROR: () => (/* reexport */ JSON_RPC_ERROR),
   METADATA_VALIDATION_FAILED: () => (/* reexport */ METADATA_VALIDATION_FAILED),
   Others: () => (/* reexport */ Others),
   Startrail: () => (/* binding */ Startrail),
@@ -54047,7 +54061,8 @@ const ERROR_MESSAGE = {
 // Formalized status code under https://eips.ethereum.org/EIPS/eip-1193#provider-errors
 const ERROR_STATUS_CODE = {
     USER_REJECTED_REQUEST: 4001,
-    METADATA_VALIDATION_FAILED: 400
+    METADATA_VALIDATION_FAILED: 400,
+    CHAINID_MISMATCH: -32603
 };
 // See: https://chainlist.org/chain/137 OR https://www.alchemy.com/chain-connect/chain/polygon-pos
 // recommended order
@@ -54060,19 +54075,14 @@ const RPC_URLS = {
         'https://polygon.llamarpc.com',
         'https://rpc-mainnet.matic.quiknode.pro',
     ],
-    // See https://www.alchemy.com/chain-connect/chain/mumbai OR https://chainlist.org/chain/137
     DEV: [
-        'https://endpoints.omniatech.io/v1/matic/mumbai/public',
-        'https://polygon-mumbai.g.alchemy.com/v2/demo',
-        'https://polygon-mumbai.blockpi.network/v1/rpc/public',
-        'https://rpc-mumbai.maticvigil.com',
-        'https://rpc.ankr.com/polygon_mumbai',
+        'https://polygon-amoy.infura.io/v3/693b51fa95334eb3bb1849da03cef748', // Infura RPC managed by Startbahn
     ]
 };
 // Host name and chainId pair is defined and validated in torus-website.
 const ETHEREUM_NETWORK = {
     PROD: { rpc: RPC_URLS.PROD[0], chainId: 137, name: 'Polygon Mainnet' },
-    DEV: { rpc: RPC_URLS.DEV[0], chainId: 80001, name: 'Mumbai' },
+    DEV: { rpc: RPC_URLS.DEV[0], chainId: 80002, name: 'Polygon Amoy Testnet' },
     LOCAL: { rpc: 'https://localhost:8545', chainId: 5777, name: 'Local' }
 };
 const GCS_URL = {
@@ -54128,6 +54138,8 @@ var StartrailSdkErrorCodeEnum;
     StartrailSdkErrorCodeEnum["WALLET_RPC_CONNECTION_FAILURE"] = "WALLET_RPC_CONNECTION_FAILURE";
     StartrailSdkErrorCodeEnum["WALLET_USER_REJECT_WALLET_REQUEST"] = "WALLET_USER_REJECT_WALLET_REQUEST";
     StartrailSdkErrorCodeEnum["METADATA_VALIDATION_FAILED"] = "METADATA_VALIDATION_FAILED";
+    StartrailSdkErrorCodeEnum["JSON_RPC_ERROR"] = "JSON_RPC_ERROR";
+    StartrailSdkErrorCodeEnum["CHAINID_MISMATCH"] = "CHAINID_MISMATCH";
 })(StartrailSdkErrorCodeEnum || (StartrailSdkErrorCodeEnum = {}));
 const TORUS_VERIFIERS = {
     google: {
@@ -54330,6 +54342,17 @@ class METADATA_VALIDATION_FAILED extends StartrailSdkErrorBase {
         this.property = { message: err.message };
     }
 }
+class JSON_RPC_ERROR extends StartrailSdkErrorBase {
+    errorCode;
+    constructor(err) {
+        super(err.message);
+        this.errorCode =
+            err.code === ERROR_STATUS_CODE.CHAINID_MISMATCH ?
+                StartrailSdkErrorCodeEnum.CHAINID_MISMATCH
+                : StartrailSdkErrorCodeEnum.JSON_RPC_ERROR;
+        this.property = { message: err?.message, stack: err?.stack };
+    }
+}
 class Others extends StartrailSdkErrorBase {
     errorCode;
     constructor(err) {
@@ -54812,6 +54835,8 @@ class CustomError {
                 throw new TORUS_THIRD_PARTY_COOKIES_UNSUPPORTED(this.err);
             case argument === trimStringWord(ERROR_MESSAGE.TORUS_FAILS_INIT):
                 throw new TORUS_FAILS_INIT(this.err);
+            case argument === 'internaljson-rpcerror' && !!this.err?.data?.cause:
+                throw new JSON_RPC_ERROR({ code: this.err.code, message: this.err.data.cause.message, stack: this.err.data.cause.stack });
             case RegExp(trimStringWord(ERROR_MESSAGE.TORUS_CACHE_CONTROL_HEADERS_UNMATCH)).test(argument):
                 throw new TORUS_CACHE_CONTROL_HEADERS_UNMATCH(this.err);
             default:
@@ -54845,6 +54870,8 @@ class CustomError {
             case ERROR_STATUS_CODE.USER_REJECTED_REQUEST:
                 // should change to wallet name ? // keep it for backward-compatible ?
                 throw new WALLET_USER_REJECT_WALLET_REQUEST(this.err);
+            case ERROR_STATUS_CODE.CHAINID_MISMATCH:
+                throw new JSON_RPC_ERROR({ code: this.err.code, message: this.err.message });
         }
         throw new Others(this.err);
     }
@@ -63896,6 +63923,9 @@ const patchDeprecateParams = (config) => {
     const { torusBuildEnv, ...res } = patchedConf;
     return res;
 };
+/**
+ * @TODO: This function may be removed just relying on Torus default RPC endpoint
+ */
 const findLiveRpcEndpoint = async (rpcList) => {
     const sendHttpRequest = async (url) => {
         const tx = new transaction(url);
@@ -63935,6 +63965,62 @@ const findEnvByChainId = (chainId) => {
     return 'PROD';
 };
 
+;// CONCATENATED MODULE: ./src/configContext/network.ts
+
+// TODO: Fully grant the liberty for users to overwrite the network configuration: https://startbahn.atlassian.net/browse/STARTRAIL-2738
+// NOTE: Given that Startrail currently only supports the Polygon main/test-net and network changes, such as from Mumbai to Amoy, do not occur frequently.
+// To minimize interface changes, the chainName and currency fields are not changeable at the moment. However, MetaMask users have the ability to manually overwrite the chain name within the extension. 
+// (It should also be doable to fetch currencies and chain names programmatically from the chainlist API in future)
+const blockchainNetwork = (param) => {
+    const { env, rpcEndpoint, chainId } = param;
+    return {
+        host: rpcEndpoint || ETHEREUM_NETWORK[env].rpc,
+        chainId: chainId || ETHEREUM_NETWORK[env].chainId,
+        chainName: ETHEREUM_NETWORK[env].name,
+        nativeCurrency: {
+            name: 'Matic',
+            symbol: 'MATIC',
+            decimals: 18
+        },
+    };
+};
+function network_create(param) {
+    if (!param.rpcEndpoint && param.chainId) {
+        throw ('rpcEndpoint is required when chainId is provided');
+    }
+    switch (param.env) {
+        case 'staging':
+            return new DevNetwork(param);
+        case 'lrc':
+            return new DevNetwork(param);
+        case 'local':
+            return new LocalNetwork(param);
+        default:
+            return new ProdNetwork(param);
+    }
+}
+class Network {
+    data;
+    constructor(param) {
+        this.data = param;
+    }
+}
+class ProdNetwork extends Network {
+    get() {
+        return blockchainNetwork({ ...this.data, env: 'PROD' });
+    }
+}
+class DevNetwork extends Network {
+    get() {
+        return blockchainNetwork({ ...this.data, env: 'DEV' });
+    }
+}
+class LocalNetwork extends Network {
+    get() {
+        return blockchainNetwork({ ...this.data, env: 'LOCAL' });
+    }
+}
+
 ;// CONCATENATED MODULE: ./src/configContext/torusSocialLogin.ts
 
 
@@ -64062,6 +64148,7 @@ const getCallabckUrl = () => {
 
 
 
+
 /**
  * Config properties for torus-embed init()
  */
@@ -64232,7 +64319,7 @@ class TorusConfigContext {
         const livezRpc = await findLiveRpcEndpoint(rpcUrls);
         if (livezRpc !== this.torusContextConfig.config.network?.host) {
             // TODO: Force all overwriteConfig relevant tasks to go through overwriteConfig function, or remvoe preConfig to restructure config to be more simple.
-            this.torusContextConfig.preConfig.network = this.network(this.torusContextConfig.config.buildEnv, livezRpc);
+            this.torusContextConfig.preConfig.network = this.network(this.torusContextConfig.config.buildEnv, livezRpc, this.torusContextConfig.preConfig.network.ethereumNetwork.chainId);
             this.torusContextConfig.config = torusConfig(this.torusContextConfig.preConfig);
         }
     }
@@ -64275,7 +64362,7 @@ class TorusConfigContext {
             ...this.torusContextConfig.preConfig,
             ...{ ...config, lang: config.lang },
             ...{
-                network: this.network(this.torusContextConfig.config.buildEnv, config?.rpcEndpoint),
+                network: this.network(this.torusContextConfig.config.buildEnv, config?.rpcEndpoint, config?.chainId),
                 loginProvider: restructureLoginConfig(config?.loginProvider),
                 conditionalWords: this.convertWordsByAuthProvider(config)
             }
@@ -64285,12 +64372,12 @@ class TorusConfigContext {
         return {
             apiPath: config?.apiPath || STARTRAIL_API,
             authAction: config?.authAction || AUTH0_DEFAULT_TAB,
-            auth0ClientId: config?.auth0ClientId || AUTH0_CLIENT_IDS[this.adaptTorusEnvToAppEnv(config?.env)],
-            auth0TorusConfigKey: config?.auth0TorusConfigKey || AUTH0_TORUS_CONFIG_KEYS[this.adaptTorusEnvToAppEnv(config?.env)],
-            auth0Domain: config?.auth0Domain || AUTH0_DOMAINS[this.adaptTorusEnvToAppEnv(config?.env)],
+            auth0ClientId: config?.auth0ClientId || AUTH0_CLIENT_IDS[this.adaptTorusEnv(config?.env).appEnv],
+            auth0TorusConfigKey: config?.auth0TorusConfigKey || AUTH0_TORUS_CONFIG_KEYS[this.adaptTorusEnv(config?.env).appEnv],
+            auth0Domain: config?.auth0Domain || AUTH0_DOMAINS[this.adaptTorusEnv(config?.env).appEnv],
             lang: (config?.lang !== LANG.JP ? LANG.EN : LANG.JP),
             loginProvider: restructureLoginConfig(config?.loginProvider),
-            network: this.network(config?.env, config?.rpcEndpoint),
+            network: this.network(config?.env, config?.rpcEndpoint, config?.chainId),
             callbackUrl: config?.callbackUrl || null,
             withModal: typeof (config?.withModal) === 'boolean' ? config?.withModal : true,
             conditionalWords: this.convertWordsByAuthProvider(config),
@@ -64298,39 +64385,18 @@ class TorusConfigContext {
             mfaLevel: config?.mfaLevel || 'none' // 'none' will skip the mfa setup screen totally. Check https://web3auth.io/docs/sdk/pnp/unreal/mfa#mfalevel
         };
     };
-    network(env, rpcEndpoint) {
-        const blockchainNetwork = (envKey) => {
-            return {
-                host: rpcEndpoint || ETHEREUM_NETWORK[envKey].rpc,
-                chainId: ETHEREUM_NETWORK[envKey].chainId
-            };
+    network(env, rpcEndpointByClient, chainIdByClient) {
+        const networkByEnv = network_create({ env, rpcEndpoint: rpcEndpointByClient, chainId: chainIdByClient });
+        const network = networkByEnv.get();
+        const envs = this.adaptTorusEnv(env);
+        return {
+            torusEnv: envs.torusEnv,
+            appEnv: envs.appEnv,
+            ethereumNetwork: {
+                host: network.host,
+                chainId: network.chainId,
+            }
         };
-        switch (env) {
-            case 'staging':
-                return {
-                    torusEnv: 'production',
-                    appEnv: this.adaptTorusEnvToAppEnv(env),
-                    ethereumNetwork: blockchainNetwork('DEV')
-                };
-            case 'lrc':
-                return {
-                    torusEnv: 'lrc',
-                    appEnv: this.adaptTorusEnvToAppEnv(env),
-                    ethereumNetwork: blockchainNetwork('DEV')
-                };
-            case 'local':
-                return {
-                    torusEnv: 'lrc',
-                    appEnv: this.adaptTorusEnvToAppEnv(env),
-                    ethereumNetwork: blockchainNetwork('LOCAL')
-                };
-            default:
-                return {
-                    torusEnv: 'production',
-                    appEnv: this.adaptTorusEnvToAppEnv(),
-                    ethereumNetwork: blockchainNetwork('PROD')
-                };
-        }
     }
     /**
      * Some wording is determined by users' action
@@ -64359,16 +64425,19 @@ class TorusConfigContext {
                 };
         }
     }
-    adaptTorusEnvToAppEnv(env) {
+    // TODO: Consider removing local env if it is not used for local development anymore.
+    adaptTorusEnv(env) {
         switch (env) {
             case 'production':
-                return 'PROD';
+                return { appEnv: 'PROD', torusEnv: 'production' };
             case 'staging':
-                return 'STG';
+                return { appEnv: 'STG', torusEnv: 'production' };
             case 'lrc':
-                return 'DEV';
+                return { appEnv: 'DEV', torusEnv: 'lrc' };
+            case 'local':
+                return { appEnv: 'DEV', torusEnv: 'lrc' };
             default:
-                return 'PROD';
+                return { appEnv: 'PROD', torusEnv: 'production' };
         }
     }
 }
@@ -64595,34 +64664,17 @@ var dist_default = /*#__PURE__*/__webpack_require__.n(dist);
 ;// CONCATENATED MODULE: ./src/configContext/metamask.ts
 
 
-function setNetwork(network, rpc) {
-    return {
-        chainId: convertNumberToHexString(network.chainId),
-        chainName: network.name,
-        rpcUrls: [rpc || network.rpc],
-        nativeCurrency: {
-            name: 'Matic',
-            symbol: 'MATIC',
-            decimals: 18
-        }
-    };
-}
 class MetamaskConfigContext {
     ethereumNetwork;
     constructor(config) {
-        switch (config?.env) {
-            case 'staging':
-                this.ethereumNetwork = setNetwork(ETHEREUM_NETWORK.DEV, config?.rpcEndpoint);
-                break;
-            case 'lrc':
-                this.ethereumNetwork = setNetwork(ETHEREUM_NETWORK.DEV, config?.rpcEndpoint);
-                break;
-            case 'local':
-                this.ethereumNetwork = setNetwork(ETHEREUM_NETWORK.LOCAL, config?.rpcEndpoint);
-                break;
-            default: // For Production
-                this.ethereumNetwork = setNetwork(ETHEREUM_NETWORK.PROD, config?.rpcEndpoint);
-        }
+        const networkByEnv = network_create({ env: config?.env, rpcEndpoint: config?.rpcEndpoint, chainId: config?.chainId });
+        const network = networkByEnv.get();
+        this.ethereumNetwork = {
+            chainId: convertNumberToHexString(network.chainId),
+            chainName: network.chainName,
+            rpcUrls: [network.host],
+            nativeCurrency: network.nativeCurrency,
+        };
     }
 }
 /* harmony default export */ const metamask = (MetamaskConfigContext);
@@ -64712,7 +64764,11 @@ class Metamask extends base {
         }
     }
     /**
-     * Request users to set Mumbai or Polygon network if not setup yet
+     * Request users to add the network in MetaMask configuration if not setup yet
+     * @see https://docs.metamask.io/wallet/reference/wallet_addethereumchain/
+     * NOTE: Test network may see "submitted RPC URL value does not match a known provider for this chain ID" warning message
+     * since they may not be listed in https://chainlist.wtf/
+     * @see https://support.metamask.io/hc/en-us/articles/360057142392-Verifying-custom-network-information
      */
     async _switchEthereumChain() {
         const env = findEnvByChainId(Number(this.configContext.ethereumNetwork.chainId));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@startbahn/startrail-sdk-js",
-  "version": "1.34.0",
+  "version": "1.35.0",
   "description": "Startrail Api for JS SDK",
   "main": "dist/startrail-sdk.js",
   "types": "types/startrail-sdk-js.d.ts",
@@ -13,7 +13,7 @@
     "build:development": "webpack --config ./config/webpack.config.js --mode development",
     "build:release": "webpack --config ./config/webpack.config.js --mode production",
     "watch": "yarn lint && webpack --watch",
-    "test": "yarn build:development && yarn jest",
+    "test": "yarn build:development && yarn jest --runInBand --logHeapUsage",
     "serve": "npx webpack-dev-server --config ./config/webpack.config.js --mode development",
     "generate-dts": "bin/generate-dts",
     "publish:beta": "sh bin/publish.sh -e qa",

package/types/startrail-sdk-js.d.ts

@@ -111,9 +111,10 @@ declare module '@startbahn/startrail-sdk-js' {
 declare module '@startbahn/startrail-sdk-js/types' {
   import { TypedDataDomain, TypedDataField } from '@ethersproject/abstract-signer';
   import type { TorusParams } from '@toruslabs/torus-embed';
-  export interface AddCustomHistoriesToSRRs extends ContractAddress, Pick<HTTPHeadersForStartrailLUW, 'startrailLUWContractAddress'> {
+  export interface AddCustomHistoriesToSRRs extends Pick<HTTPHeadersForStartrailLUW, 'startrailLUWContractAddress'> {
       tokenIds: string[];
       customHistoryIds: string[];
+      contractAddress?: string;
   }
   export interface AdditionalRequestProps {
       startrailLUWContractAddress?: string;
@@ -128,13 +129,15 @@ declare module '@startbahn/startrail-sdk-js/types' {
       signup: boolean;
   }
   export interface ApproveSRRByCommitment extends ApproveSRRByCommitmentShared, Pick<HTTPHeadersForStartrail, 'startrailLUWContractAddress'> {
+      contractAddress?: string;
   }
-  export interface ApproveSRRByCommitmentShared extends ContractAddress {
+  export interface ApproveSRRByCommitmentShared {
       preimage?: string;
       revealHash?: string;
       tokenId: string;
       metadata: HistoryMetadata;
       isHashPreimageEnabled?: boolean;
+      contractAddress?: string;
   }
   export interface ApproveSRRByCommitmentDto {
       metadata: HistoryMetadata;
@@ -150,6 +153,7 @@ declare module '@startbahn/startrail-sdk-js/types' {
       apiPath?: string;
       env?: StartrailEnv;
       rpcEndpoint?: string;
+      chainId?: number;
   }
   export interface ConvertMetadata {
       metadataBatch: {
@@ -220,21 +224,21 @@ declare module '@startbahn/startrail-sdk-js/types' {
           salt: string;
       };
   }
-  interface ContractAddress {
-      contractAddress?: string;
-  }
   export interface CreateSRR extends CreateSRRForRequest, Pick<HTTPHeadersForStartrailLUW, 'startrailLUWContractAddress'> {
+      contractAddress?: string;
   }
-  export interface CreateSRRForRequest extends ContractAddress {
+  export interface CreateSRRForRequest {
       isPrimaryIssuer: boolean;
       metadata: object;
       artistAddress: string;
       lockExternalTransfer: boolean;
+      contractAddress?: string;
   }
-  export interface IERC2981RoyaltyRequest extends ContractAddress {
+  export interface IERC2981RoyaltyRequest {
       tokenId?: string;
       metadata?: object;
       issuerAddress?: string;
+      contractAddress?: string;
   }
   export interface IERC2981RoyaltyResponse {
       royaltyReceiver: string | null;
@@ -265,8 +269,9 @@ declare module '@startbahn/startrail-sdk-js/types' {
       version?: string;
       $schemaIntegrity?: string;
   }
-  export interface TransferFromWithProvenanceWithMetadataUpdate extends ContractAddress, TransferFromWithProvenance {
+  export interface TransferFromWithProvenanceWithMetadataUpdate extends TransferFromWithProvenance {
       metadata: HistoryMetadata;
+      contractAddress?: string;
   }
   export interface HTTPHeadersForStartrailLUW {
       startrailLUWContractAddress: string;
@@ -384,6 +389,7 @@ declare module '@startbahn/startrail-sdk-js/types' {
       channelNonce: string;
   }
   export interface TransferFromWithProvenance extends TransferFromWithProvenanceShared, Pick<HTTPHeadersForStartrailLUW, 'startrailLUWContractAddress'> {
+      contractAddress?: string;
   }
   export interface Bulk extends Pick<HTTPHeadersForStartrailLUW, 'startrailLUWContractAddress'> {
       isCompressEnabled: boolean;
@@ -392,11 +398,12 @@ declare module '@startbahn/startrail-sdk-js/types' {
           data: ApproveSRRByCommitmentShared | CreateSRRForRequest | TransferFromWithProvenanceShared;
       }[];
   }
-  export interface TransferFromWithProvenanceShared extends ContractAddress {
+  export interface TransferFromWithProvenanceShared {
       to: string;
       tokenId: string;
       metadata: HistoryMetadata;
       isIntermediary?: boolean;
+      contractAddress?: string;
   }
   export interface TTransferFromWithProvenanceDto extends Omit<TransferFromWithProvenanceShared, 'tokenId'> {
   }
@@ -406,9 +413,10 @@ declare module '@startbahn/startrail-sdk-js/types' {
       channelNonce?: string;
       requestData: object;
   }
-  export interface UpdateMetadata extends ContractAddress, Pick<HTTPHeadersForStartrailLUW, 'startrailLUWContractAddress'> {
+  export interface UpdateMetadata extends Pick<HTTPHeadersForStartrailLUW, 'startrailLUWContractAddress'> {
       tokenId: string;
       metadata: object;
+      contractAddress?: string;
   }
   export type RequestMethod = 'post' | 'put';
   export interface ResponseOfConvertMetadata {
@@ -690,6 +698,14 @@ declare module '@startbahn/startrail-sdk-js/errorClass' {
     errorCode: StartrailSdkErrorCodeEnum.METADATA_VALIDATION_FAILED;
     constructor(err: any);
   }
+  export class JSON_RPC_ERROR extends StartrailSdkErrorBase {
+    errorCode: StartrailSdkErrorCodeEnum.JSON_RPC_ERROR | StartrailSdkErrorCodeEnum.CHAINID_MISMATCH;
+    constructor(err: {
+      message: string;
+      code?: number;
+      stack?: string;
+    });
+  }
   export class Others extends StartrailSdkErrorBase {
     errorCode: StartrailSdkErrorCodeEnum.OTHERS;
     constructor(err: any);
@@ -869,6 +885,7 @@ declare module '@startbahn/startrail-sdk-js/constant' {
   export const ERROR_STATUS_CODE: {
     USER_REJECTED_REQUEST: number;
     METADATA_VALIDATION_FAILED: number;
+    CHAINID_MISMATCH: number;
   };
   export const RPC_URLS: {
     PROD: string[];
@@ -936,13 +953,21 @@ declare module '@startbahn/startrail-sdk-js/constant' {
     WALLET_NOT_SUPPORT_FUNCTION = "WALLET_NOT_SUPPORT_FUNCTION",
     WALLET_RPC_CONNECTION_FAILURE = "WALLET_RPC_CONNECTION_FAILURE",
     WALLET_USER_REJECT_WALLET_REQUEST = "WALLET_USER_REJECT_WALLET_REQUEST",
-    METADATA_VALIDATION_FAILED = "METADATA_VALIDATION_FAILED"
+    METADATA_VALIDATION_FAILED = "METADATA_VALIDATION_FAILED",
+    JSON_RPC_ERROR = "JSON_RPC_ERROR",
+    CHAINID_MISMATCH = "CHAINID_MISMATCH"
   }
   export type ERROR_FROM_TYPE = 'StartrailSdk';
   export type ERROR_TYPE = {
     code: number | string;
     message: string;
     statusCode: number;
+    data?: {
+      cause?: {
+        message: string;
+        stack: string;
+      };
+    };
   };
   export const TORUS_VERIFIERS: {
     [key in LoginProvider]: {