@d9-network/ink 0.2.0 → 1.0.0

package/README.md

@@ -20,7 +20,7 @@ import { usdt } from "@d9-network/spec"; // Contract descriptor
 
 // Create SDK instance
 const sdk = await createD9InkSdk({
-  endpoint: "wss://mainnet.d9network.xyz:40300",
+  endpoint: "wss://mainnet.d9network.com:40300",
 });
 
 // Create contract instance
@@ -75,7 +75,7 @@ if (result.success) {
 
 For complete documentation, examples, and API reference, visit:
 
-- [D9 SDK Documentation](https://docs.d9network.xyz/docs/sdk/ink/overview)
+- [D9 SDK Documentation](https://docs.d9network.com/docs/sdk/ink/overview)
 
 ## License
 

package/dist/index.cjs

@@ -5,39 +5,9 @@ let _polkadot_labs_hdkd_helpers = require("@polkadot-labs/hdkd-helpers");
 let _subsquid_scale_codec = require("@subsquid/scale-codec");
 let _polkadot_api_substrate_bindings = require("@polkadot-api/substrate-bindings");
 let _noble_hashes_blake2_js = require("@noble/hashes/blake2.js");
+let _d9_network_spec = require("@d9-network/spec");
 let rxjs = require("rxjs");
 
-//#region src/constants.ts
-/**
-* D9 Network constants
-*/
-/**
-* D9 SS58 address prefix.
-*
-* SS58 is the address format used by Substrate-based chains. Each chain has a unique
-* prefix that determines the address format and ensures addresses are network-specific.
-*
-* D9 uses prefix 9, which produces addresses starting with 'c' or 'd'.
-*
-* This prefix is automatically applied to all AccountId encoding/decoding operations
-* in the SDK, including:
-* - Contract call parameter encoding
-* - Result decoding
-* - Event parsing
-*
-* @see https://github.com/paritytech/ss58-registry for the full SS58 registry
-*/
-const D9_SS58_PREFIX = 9;
-/** D9 token decimals */
-const D9_DECIMALS = 12;
-/** D9 token symbol */
-const D9_SYMBOL = "D9";
-/** USDT token decimals */
-const USDT_DECIMALS = 2;
-/** USDT token symbol */
-const USDT_SYMBOL = "USDT";
-
-//#endregion
 //#region src/encode.ts
 /**
 * Encode a contract call for ContractsApi_call state_call.
@@ -299,7 +269,7 @@ function buildPrimitiveCodec$1(primitive) {
 * Build codec for special types based on path
 */
 function buildSpecialTypeCodec$1(path, typeEntry, types, cache) {
-	if (path.join("::").includes("AccountId")) return (0, _polkadot_api_substrate_bindings.AccountId)(D9_SS58_PREFIX);
+	if (path.join("::").includes("AccountId")) return (0, _polkadot_api_substrate_bindings.AccountId)(_d9_network_spec.D9_SS58_PREFIX);
 	if (path[0] === "Option") {
 		const params = typeEntry.type.params;
 		if (params && params.length > 0 && params[0]?.type !== void 0) return (0, _polkadot_api_substrate_bindings.Option)(buildCodecFromType(params[0].type, types, cache));
@@ -942,161 +912,35 @@ function createMessageBuilder(descriptor) {
 }
 
 //#endregion
-//#region src/errors.ts
-/**
-* Base error class for all contract-related errors
-*/
-var ContractError = class ContractError extends Error {
-	timestamp;
-	cause;
-	constructor(message, type, label, details, cause) {
-		super(message, { cause });
-		this.type = type;
-		this.label = label;
-		this.details = details;
-		this.name = "ContractError";
-		this.timestamp = /* @__PURE__ */ new Date();
-		if (Error.captureStackTrace) Error.captureStackTrace(this, ContractError);
-	}
-	/**
-	* Create a formatted error message for logging
-	*/
-	toLogString() {
-		const parts = [
-			`[${this.type}]`,
-			this.label ? `${this.label}:` : "",
-			this.message
-		].filter(Boolean);
-		if (this.details) parts.push(`Details: ${JSON.stringify(this.details)}`);
-		return parts.join(" ");
-	}
-	/**
-	* Convert to a plain object for serialization
-	*/
-	toJSON() {
-		return {
-			name: this.name,
-			type: this.type,
-			message: this.message,
-			label: this.label,
-			details: this.details,
-			timestamp: this.timestamp.toISOString(),
-			stack: this.stack
-		};
-	}
-};
-/**
-* Error thrown when contract metadata is missing or invalid
-*/
-var MetadataError = class extends ContractError {
-	constructor(message, details) {
-		super(message, "METADATA_ERROR", void 0, details);
-		this.name = "MetadataError";
-	}
-};
-/**
-* Error thrown when encoding call data fails
-*/
-var EncodeError = class extends ContractError {
-	constructor(label, message, details) {
-		super(message, "ENCODE_ERROR", label, details);
-		this.name = "EncodeError";
-	}
-};
-/**
-* Error thrown when decoding response fails
-*/
-var DecodeError = class extends ContractError {
-	constructor(label, message, details) {
-		super(message, "DECODE_ERROR", label, details);
-		this.name = "DecodeError";
-	}
-};
-/**
-* Error thrown for network/RPC errors
-*/
-var NetworkError = class extends ContractError {
-	constructor(message, cause, details) {
-		super(message, "NETWORK_ERROR", void 0, details, cause);
-		this.name = "NetworkError";
-	}
-};
-/**
-* Error thrown when contract returns an error result
-*/
-var ContractExecutionError = class extends ContractError {
-	constructor(label, errorValue) {
-		super(`Contract execution failed: ${JSON.stringify(errorValue)}`, "CONTRACT_ERROR", label, errorValue);
-		this.errorValue = errorValue;
-		this.name = "ContractExecutionError";
-	}
-};
-/**
-* Error thrown for Ink LangError
-*/
-var LangError = class extends ContractError {
-	constructor(label, variant) {
-		const variantName = variant === 1 ? "CouldNotReadInput" : `Unknown(${variant})`;
-		super(`Ink LangError: ${variantName}`, "LANG_ERROR", label, {
-			variant,
-			variantName
-		});
-		this.variant = variant;
-		this.name = "LangError";
-	}
-};
-/**
-* Error thrown when request times out
-*/
-var TimeoutError = class extends ContractError {
-	constructor(label, timeoutMs) {
-		super(`Request timed out after ${timeoutMs}ms`, "TIMEOUT_ERROR", label, { timeoutMs });
-		this.timeoutMs = timeoutMs;
-		this.name = "TimeoutError";
-	}
-};
-/**
-* Error thrown when request is aborted
-*/
-var AbortedError = class extends ContractError {
-	constructor(label, reason) {
-		super(reason || "Request was aborted", "ABORTED", label, { reason });
-		this.name = "AbortedError";
-	}
-};
-/**
-* Error thrown for signer-related issues
-*/
-var SignerError = class extends ContractError {
-	constructor(message, details) {
-		super(message, "SIGNER_ERROR", void 0, details);
-		this.name = "SignerError";
-	}
-};
-/**
-* Error thrown when transaction submission fails
-*/
-var TransactionError = class extends ContractError {
-	constructor(label, message, txHash, details) {
-		super(message, "TX_ERROR", label, {
-			...details,
-			txHash
-		});
-		this.txHash = txHash;
-		this.name = "TransactionError";
-	}
-};
-/**
-* Type guard to check if an error is a ContractError
-*/
-function isContractError(error) {
-	return error instanceof ContractError;
-}
+//#region src/rpc.ts
 /**
-* Type guard to check for specific error types
+* Create a type-safe RPC proxy from a PolkadotClient
+*
+* This wraps the client's `_request` method with a Proxy that provides
+* a dot-syntax interface with proper TypeScript types.
+*
+* @param client - The PolkadotClient instance
+* @returns A type-safe RPC proxy object
+*
+* @example
+* ```ts
+* const rpc = createTypedRpc(client);
+*
+* // Dot syntax with full type inference
+* const hash = await rpc.chain_getBlockHash(12345);
+* // hash: HexString | null
+*
+* const header = await rpc.chain_getHeader(hash);
+* // header: BlockHeader | null
+*
+* const result = await rpc.state_call("ContractsApi_call", message, blockHash);
+* // result: HexString
+* ```
 */
-function isErrorType(error, type) {
-	return isContractError(error) && error.type === type;
+function createTypedRpc(client) {
+	return new Proxy({}, { get(_target, prop) {
+		return (...args) => client._request(prop, args);
+	} });
 }
 
 //#endregion
@@ -1124,7 +968,7 @@ function decodeWithPapiFallback(innerData, codec, method) {
 			};
 			return {
 				success: false,
-				error: new DecodeError(method, `Contract returned error: ${JSON.stringify(papiResult.value)}`, papiResult.value)
+				error: new _d9_network_spec.DecodeError(method, `Contract returned error: ${JSON.stringify(papiResult.value)}`, papiResult.value)
 			};
 		}
 		return {
@@ -1134,7 +978,7 @@ function decodeWithPapiFallback(innerData, codec, method) {
 	} catch (error) {
 		return {
 			success: false,
-			error: new DecodeError(method, `Failed to decode response: ${error instanceof Error ? error.message : String(error)}`, { error })
+			error: new _d9_network_spec.DecodeError(method, `Failed to decode response: ${error instanceof Error ? error.message : String(error)}`, { error })
 		};
 	}
 }
@@ -1176,7 +1020,7 @@ function createTimeout(ms, label) {
 	return {
 		promise: new Promise((_, reject) => {
 			timeoutId = setTimeout(() => {
-				reject(new TimeoutError(label, ms));
+				reject(new _d9_network_spec.TimeoutError(label, ms));
 			}, ms);
 		}),
 		clear: () => clearTimeout(timeoutId)
@@ -1186,14 +1030,14 @@ function createTimeout(ms, label) {
 * Check if AbortSignal is aborted and throw if so
 */
 function checkAborted(signal, label) {
-	if (signal?.aborted) throw new AbortedError(label, signal.reason);
+	if (signal?.aborted) throw new _d9_network_spec.AbortedError(label, signal.reason);
 }
 /**
 * Create a D9 Ink Contract instance
 */
 function createD9InkContract(descriptor, address, options) {
 	const { client, typedApi, defaultQueryOptions = {}, defaultSendOptions = {} } = options;
-	if (!descriptor.metadata) throw new MetadataError("Contract descriptor must include metadata");
+	if (!descriptor.metadata) throw new _d9_network_spec.MetadataError("Contract descriptor must include metadata");
 	const patchedMetadata = patchLangErrorInMetadata(descriptor.metadata);
 	const builder = (0, _polkadot_api_ink_contracts.getInkDynamicBuilder)((0, _polkadot_api_ink_contracts.getInkLookup)(patchedMetadata));
 	const patchedDescriptor = {
@@ -1208,6 +1052,7 @@ function createD9InkContract(descriptor, address, options) {
 		codecRegistry = /* @__PURE__ */ new Map();
 	}
 	const addressBytes = ss58ToBytes(address);
+	const rpc = createTypedRpc(client);
 	const messageCodecCache = /* @__PURE__ */ new Map();
 	function getMessageCodec(label) {
 		const cached = messageCodecCache.get(label);
@@ -1238,11 +1083,7 @@ function createD9InkContract(descriptor, address, options) {
 			const blockHash = at ?? (await client.getFinalizedBlock()).hash;
 			checkAborted(signal, method);
 			const executeCall = async () => {
-				return (0, polkadot_api_utils.fromHex)(await client._request("state_call", [
-					"ContractsApi_call",
-					message$1,
-					blockHash
-				]));
+				return (0, polkadot_api_utils.fromHex)(await rpc.state_call("ContractsApi_call", message$1, blockHash));
 			};
 			let rawResponse;
 			if (timeout) {
@@ -1257,11 +1098,11 @@ function createD9InkContract(descriptor, address, options) {
 			const callResult = decodeContractCallResult(rawResponse);
 			if (!callResult.success) return {
 				success: false,
-				error: new ContractError(`Contract execution failed: ${callResult.debugMessage}`, "CONTRACT_ERROR", method)
+				error: new _d9_network_spec.ContractError(`Contract execution failed: ${callResult.debugMessage}`, "CONTRACT_ERROR", method)
 			};
 			if (isLangError(callResult.data)) return {
 				success: false,
-				error: new LangError(method, callResult.data[1] ?? 1)
+				error: new _d9_network_spec.LangError(method, callResult.data[1] ?? 1)
 			};
 			const innerData = unwrapInkResult(callResult.data);
 			let decodedResponse;
@@ -1300,13 +1141,13 @@ function createD9InkContract(descriptor, address, options) {
 				})
 			};
 		} catch (error) {
-			if (error instanceof ContractError) return {
+			if (error instanceof _d9_network_spec.ContractError) return {
 				success: false,
 				error
 			};
 			return {
 				success: false,
-				error: new ContractError(error instanceof Error ? error.message : String(error), "NETWORK_ERROR", method)
+				error: new _d9_network_spec.ContractError(error instanceof Error ? error.message : String(error), "NETWORK_ERROR", method)
 			};
 		}
 	}
@@ -1323,17 +1164,13 @@ function createD9InkContract(descriptor, address, options) {
 		return {
 			getEncodedData: () => callData,
 			async signAndSubmit(signer) {
-				if (!typedApi) throw new TransactionError(method, "typedApi is required for transaction submission. Pass typedApi in SDK options.");
+				if (!typedApi) throw new _d9_network_spec.TransactionError(method, "typedApi is required for transaction submission. Pass typedApi in SDK options.");
 				try {
 					let gas = gasLimit;
 					if (!gas) {
 						const message$1 = encodeContractCall(originBytes, addressBytes, callData, value);
 						const blockHash = (await client.getFinalizedBlock()).hash;
-						gas = decodeContractCallResult((0, polkadot_api_utils.fromHex)(await client._request("state_call", [
-							"ContractsApi_call",
-							message$1,
-							blockHash
-						]))).gas.gasRequired;
+						gas = decodeContractCallResult((0, polkadot_api_utils.fromHex)(await rpc.state_call("ContractsApi_call", message$1, blockHash))).gas.gasRequired;
 					}
 					const txResult = await typedApi.tx.Contracts.call({
 						dest: {
@@ -1393,14 +1230,14 @@ function createD9InkContract(descriptor, address, options) {
 				notImplementedWarning("getRoot");
 				return {
 					success: false,
-					value: new ContractError("Storage queries not yet implemented. Use contract messages to read state.", "METADATA_ERROR")
+					value: new _d9_network_spec.ContractError("Storage queries not yet implemented. Use contract messages to read state.", "METADATA_ERROR")
 				};
 			},
 			async getNested(path, ..._keys) {
 				notImplementedWarning("getNested");
 				return {
 					success: false,
-					value: new ContractError(`Storage query for "${path}" not yet implemented. Use contract messages to read state.`, "METADATA_ERROR")
+					value: new _d9_network_spec.ContractError(`Storage query for "${path}" not yet implemented. Use contract messages to read state.`, "METADATA_ERROR")
 				};
 			}
 		};
@@ -1451,37 +1288,6 @@ function createD9InkContract(descriptor, address, options) {
 	};
 }
 
-//#endregion
-//#region src/rpc.ts
-/**
-* Create a type-safe RPC request function from a PolkadotClient
-*
-* This wraps the client's `_request` method with proper TypeScript types,
-* providing autocomplete for known RPC methods and type inference for
-* parameters and return values.
-*
-* @param client - The PolkadotClient instance
-* @returns A type-safe RPC request function
-*
-* @example
-* ```ts
-* const rpc = createTypedRpc(client);
-*
-* // Autocomplete for method names, typed params and return
-* const hash = await rpc("chain_getBlockHash", [12345]);
-* // hash: HexString | null
-*
-* const header = await rpc("chain_getHeader", [hash]);
-* // header: BlockHeader | null
-*
-* // Custom methods still work with explicit types
-* const custom = await rpc<MyType>("my_custom_method", [arg]);
-* ```
-*/
-function createTypedRpc(client) {
-	return ((method, params) => client._request(method, params));
-}
-
 //#endregion
 //#region src/sdk.ts
 /**
@@ -1622,7 +1428,7 @@ function buildPrimitiveCodec(primitive) {
 	}
 }
 function buildSpecialTypeCodec(path, typeEntry, types, cache) {
-	if (path.join("::").includes("AccountId")) return (0, _polkadot_api_substrate_bindings.AccountId)(D9_SS58_PREFIX);
+	if (path.join("::").includes("AccountId")) return (0, _polkadot_api_substrate_bindings.AccountId)(_d9_network_spec.D9_SS58_PREFIX);
 	if (path[0] === "Option") {
 		const params = typeEntry.type.params;
 		if (params && params.length > 0 && params[0]?.type !== void 0) return (0, _polkadot_api_substrate_bindings.Option)(buildCodecFromTypeInternal(params[0].type, types, cache));
@@ -2019,25 +1825,75 @@ function gasExceedsLimit(gas, limit) {
 }
 
 //#endregion
-exports.AbortedError = AbortedError;
+Object.defineProperty(exports, 'AbortedError', {
+  enumerable: true,
+  get: function () {
+    return _d9_network_spec.AbortedError;
+  }
+});
 exports.ContractCallParser = ContractCallParser;
-exports.ContractError = ContractError;
+Object.defineProperty(exports, 'ContractError', {
+  enumerable: true,
+  get: function () {
+    return _d9_network_spec.ContractError;
+  }
+});
 exports.ContractEventParser = ContractEventParser;
-exports.ContractExecutionError = ContractExecutionError;
-exports.D9_DECIMALS = D9_DECIMALS;
-exports.D9_SS58_PREFIX = D9_SS58_PREFIX;
-exports.D9_SYMBOL = D9_SYMBOL;
-exports.DecodeError = DecodeError;
-exports.EncodeError = EncodeError;
+Object.defineProperty(exports, 'ContractExecutionError', {
+  enumerable: true,
+  get: function () {
+    return _d9_network_spec.ContractExecutionError;
+  }
+});
+Object.defineProperty(exports, 'DecodeError', {
+  enumerable: true,
+  get: function () {
+    return _d9_network_spec.DecodeError;
+  }
+});
+Object.defineProperty(exports, 'EncodeError', {
+  enumerable: true,
+  get: function () {
+    return _d9_network_spec.EncodeError;
+  }
+});
 exports.InkCodecs = InkCodecs;
-exports.LangError = LangError;
-exports.MetadataError = MetadataError;
-exports.NetworkError = NetworkError;
-exports.SignerError = SignerError;
-exports.TimeoutError = TimeoutError;
-exports.TransactionError = TransactionError;
-exports.USDT_DECIMALS = USDT_DECIMALS;
-exports.USDT_SYMBOL = USDT_SYMBOL;
+Object.defineProperty(exports, 'LangError', {
+  enumerable: true,
+  get: function () {
+    return _d9_network_spec.LangError;
+  }
+});
+Object.defineProperty(exports, 'MetadataError', {
+  enumerable: true,
+  get: function () {
+    return _d9_network_spec.MetadataError;
+  }
+});
+Object.defineProperty(exports, 'NetworkError', {
+  enumerable: true,
+  get: function () {
+    return _d9_network_spec.NetworkError;
+  }
+});
+Object.defineProperty(exports, 'SignerError', {
+  enumerable: true,
+  get: function () {
+    return _d9_network_spec.SignerError;
+  }
+});
+Object.defineProperty(exports, 'TimeoutError', {
+  enumerable: true,
+  get: function () {
+    return _d9_network_spec.TimeoutError;
+  }
+});
+Object.defineProperty(exports, 'TransactionError', {
+  enumerable: true,
+  get: function () {
+    return _d9_network_spec.TransactionError;
+  }
+});
 exports.applyGasMargin = applyGasMargin;
 exports.buildAllEventDecoders = buildAllEventDecoders;
 exports.buildAllMessageDecoders = buildAllMessageDecoders;
@@ -2063,8 +1919,18 @@ exports.formatGasInfo = formatGasInfo;
 exports.gasExceedsLimit = gasExceedsLimit;
 exports.getEventSignature = getEventSignature;
 exports.isCallType = isCallType;
-exports.isContractError = isContractError;
-exports.isErrorType = isErrorType;
+Object.defineProperty(exports, 'isContractError', {
+  enumerable: true,
+  get: function () {
+    return _d9_network_spec.isContractError;
+  }
+});
+Object.defineProperty(exports, 'isErrorType', {
+  enumerable: true,
+  get: function () {
+    return _d9_network_spec.isErrorType;
+  }
+});
 exports.isEventType = isEventType;
 exports.isLangError = isLangError;
 exports.unwrapInkResult = unwrapInkResult;