@d9-network/ink 0.1.1 → 1.0.0

package/dist/index.mjs

@@ -5,24 +5,9 @@ import { ss58Decode } from "@polkadot-labs/hdkd-helpers";
 import { HexSink, Src } from "@subsquid/scale-codec";
 import { AccountId, Bytes as Bytes$1, Option, Struct, Tuple, Variant, Vector, _void, bool, i128, i16, i32, i64, i8, str, u128, u16, u32, u64, u8 } from "@polkadot-api/substrate-bindings";
 import { blake2b } from "@noble/hashes/blake2.js";
+import { AbortedError, AbortedError as AbortedError$1, ContractError, ContractError as ContractError$1, ContractExecutionError, D9_SS58_PREFIX, DecodeError, DecodeError as DecodeError$1, EncodeError, LangError, LangError as LangError$1, MetadataError, MetadataError as MetadataError$1, NetworkError, SignerError, TimeoutError, TimeoutError as TimeoutError$1, TransactionError, TransactionError as TransactionError$1, isContractError, isErrorType } from "@d9-network/spec";
 import { catchError, filter, from, map, mergeMap, of, share } from "rxjs";
 
-//#region src/constants.ts
-/**
-* D9 Network constants
-*/
-/** D9 SS58 address prefix */
-const D9_SS58_PREFIX = 9;
-/** D9 token decimals */
-const D9_DECIMALS = 2;
-/** 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.
@@ -152,13 +137,6 @@ function decodeContractCallResult(result) {
 	};
 }
 /**
-* Legacy function - decode and return just the exec result data.
-* @deprecated Use decodeContractCallResult for full information
-*/
-function decodeResult(result) {
-	return decodeContractCallResult(result).data;
-}
-/**
 * Unwrap the inner value from Result<T, LangError> by checking the variant byte.
 *
 * Ink contracts wrap their return values in Result<T, LangError>.
@@ -934,166 +912,77 @@ 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
 //#region src/contract.ts
 /**
+* Decode response data using papi's value codec with proper result unwrapping.
+* This helper handles the common pattern of wrapping inner data in an Ok variant
+* and extracting the actual value from papi's decoded result.
+*
+* @param innerData - The raw response bytes to decode
+* @param codec - The papi codec with value.dec method
+* @param method - Method name for error context
+* @returns Decoded value or error
+*/
+function decodeWithPapiFallback(innerData, codec, method) {
+	try {
+		const fullResult = new Uint8Array(1 + innerData.length);
+		fullResult[0] = 0;
+		fullResult.set(innerData, 1);
+		const papiResult = codec.value.dec(fullResult);
+		if (papiResult !== null && typeof papiResult === "object" && "success" in papiResult && "value" in papiResult) {
+			if (papiResult.success) return {
+				success: true,
+				value: papiResult.value
+			};
+			return {
+				success: false,
+				error: new DecodeError$1(method, `Contract returned error: ${JSON.stringify(papiResult.value)}`, papiResult.value)
+			};
+		}
+		return {
+			success: true,
+			value: papiResult
+		};
+	} catch (error) {
+		return {
+			success: false,
+			error: new DecodeError$1(method, `Failed to decode response: ${error instanceof Error ? error.message : String(error)}`, { error })
+		};
+	}
+}
+/**
 * Patch LangError type in ink metadata to fix the missing index 0 variant issue.
 * Uses structuredClone for efficient deep cloning.
 */
@@ -1131,7 +1020,7 @@ function createTimeout(ms, label) {
 	return {
 		promise: new Promise((_, reject) => {
 			timeoutId = setTimeout(() => {
-				reject(new TimeoutError(label, ms));
+				reject(new TimeoutError$1(label, ms));
 			}, ms);
 		}),
 		clear: () => clearTimeout(timeoutId)
@@ -1141,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 AbortedError$1(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 MetadataError$1("Contract descriptor must include metadata");
 	const patchedMetadata = patchLangErrorInMetadata(descriptor.metadata);
 	const builder = getInkDynamicBuilder(getInkLookup(patchedMetadata));
 	const patchedDescriptor = {
@@ -1163,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);
@@ -1193,11 +1083,7 @@ function createD9InkContract(descriptor, address, options) {
 			const blockHash = at ?? (await client.getFinalizedBlock()).hash;
 			checkAborted(signal, method);
 			const executeCall = async () => {
-				return fromHex(await client._request("state_call", [
-					"ContractsApi_call",
-					message$1,
-					blockHash
-				]));
+				return fromHex(await rpc.state_call("ContractsApi_call", message$1, blockHash));
 			};
 			let rawResponse;
 			if (timeout) {
@@ -1212,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 ContractError$1(`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 LangError$1(method, callResult.data[1] ?? 1)
 			};
 			const innerData = unwrapInkResult(callResult.data);
 			let decodedResponse;
@@ -1225,35 +1111,20 @@ function createD9InkContract(descriptor, address, options) {
 				decodedResponse = decoder.dec(innerData);
 			} catch (decodeError) {
 				console.warn("D9InkContract: Failed to decode response:", decodeError);
-				const fullResult = new Uint8Array(1 + innerData.length);
-				fullResult[0] = 0;
-				fullResult.set(innerData, 1);
-				try {
-					const papiResult = codec.value.dec(fullResult);
-					if (papiResult !== null && typeof papiResult === "object" && "success" in papiResult && "value" in papiResult) if (papiResult.success) decodedResponse = papiResult.value;
-					else return {
-						success: false,
-						error: new DecodeError(method, `Contract returned error: ${JSON.stringify(papiResult.value)}`, papiResult.value)
-					};
-					else decodedResponse = papiResult;
-				} catch (error) {
-					return {
-						success: false,
-						error: new DecodeError(method, `Failed to decode response: ${error instanceof Error ? error.message : String(error)}`, { error })
-					};
-				}
+				const fallbackResult = decodeWithPapiFallback(innerData, codec, method);
+				if (!fallbackResult.success) return {
+					success: false,
+					error: fallbackResult.error
+				};
+				decodedResponse = fallbackResult.value;
 			}
 			else {
-				const fullResult = new Uint8Array(1 + innerData.length);
-				fullResult[0] = 0;
-				fullResult.set(innerData, 1);
-				const papiResult = codec.value.dec(fullResult);
-				if (papiResult !== null && typeof papiResult === "object" && "success" in papiResult && "value" in papiResult) if (papiResult.success) decodedResponse = papiResult.value;
-				else return {
+				const fallbackResult = decodeWithPapiFallback(innerData, codec, method);
+				if (!fallbackResult.success) return {
 					success: false,
-					error: new DecodeError(method, `Contract returned error: ${JSON.stringify(papiResult.value)}`, papiResult.value)
+					error: fallbackResult.error
 				};
-				else decodedResponse = papiResult;
+				decodedResponse = fallbackResult.value;
 			}
 			return {
 				success: true,
@@ -1270,13 +1141,13 @@ function createD9InkContract(descriptor, address, options) {
 				})
 			};
 		} catch (error) {
-			if (error instanceof ContractError) return {
+			if (error instanceof ContractError$1) return {
 				success: false,
 				error
 			};
 			return {
 				success: false,
-				error: new ContractError(error instanceof Error ? error.message : String(error), "NETWORK_ERROR", method)
+				error: new ContractError$1(error instanceof Error ? error.message : String(error), "NETWORK_ERROR", method)
 			};
 		}
 	}
@@ -1293,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 TransactionError$1(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(fromHex(await client._request("state_call", [
-							"ContractsApi_call",
-							message$1,
-							blockHash
-						]))).gas.gasRequired;
+						gas = decodeContractCallResult(fromHex(await rpc.state_call("ContractsApi_call", message$1, blockHash))).gas.gasRequired;
 					}
 					const txResult = await typedApi.tx.Contracts.call({
 						dest: {
@@ -1346,22 +1213,31 @@ function createD9InkContract(descriptor, address, options) {
 		return createSendableTransaction(method, sendOptions);
 	}
 	/**
-	* Create storage query interface
+	* Create storage query interface.
+	*
+	* @deprecated Storage queries are not yet implemented. This API is exposed for
+	* future compatibility but will throw errors if used. Use contract messages
+	* (query/send) to read contract state instead.
+	*
+	* @returns ContractStorage interface with unimplemented methods
 	*/
 	function getStorage() {
+		const notImplementedWarning = (method) => {
+			console.warn(`[D9InkContract] ${method}() is not implemented. Storage queries are planned for a future release. Use contract messages to read state instead.`);
+		};
 		return {
 			async getRoot() {
-				console.warn("D9InkContract: getRoot not implemented");
+				notImplementedWarning("getRoot");
 				return {
 					success: false,
-					value: new ContractError("Storage queries not yet implemented", "METADATA_ERROR")
+					value: new ContractError$1("Storage queries not yet implemented. Use contract messages to read state.", "METADATA_ERROR")
 				};
 			},
 			async getNested(path, ..._keys) {
-				console.warn("D9InkContract: getNested not implemented");
+				notImplementedWarning("getNested");
 				return {
 					success: false,
-					value: new ContractError(`Storage query for "${path}" not yet implemented`, "METADATA_ERROR")
+					value: new ContractError$1(`Storage query for "${path}" not yet implemented. Use contract messages to read state.`, "METADATA_ERROR")
 				};
 			}
 		};
@@ -1412,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
 /**
@@ -1980,5 +1825,5 @@ function gasExceedsLimit(gas, limit) {
 }
 
 //#endregion
-export { AbortedError, ContractCallParser, ContractError, ContractEventParser, ContractExecutionError, D9_DECIMALS, D9_SS58_PREFIX, D9_SYMBOL, DecodeError, EncodeError, InkCodecs, LangError, MetadataError, NetworkError, SignerError, TimeoutError, TransactionError, USDT_DECIMALS, USDT_SYMBOL, applyGasMargin, buildAllEventDecoders, buildAllMessageDecoders, buildEventDecoder, buildMessageDecoder, compareGasWeight, createAsciiEventTopic, createCodecRegistry, createContractEventStream, createD9InkContract, createD9InkSdk, createMessageBuilder, createNativeTransferStream, createPSP22TransferStream, createTypedRpc, decodeContractCallResult, decodeInkValue, decodeResult, encodeCall, encodeContractCall, encodeContractCallWithLimits, estimateTransactionCost, formatGasInfo, gasExceedsLimit, getEventSignature, isCallType, isContractError, isErrorType, isEventType, isLangError, unwrapInkResult };
+export { AbortedError, ContractCallParser, ContractError, ContractEventParser, ContractExecutionError, DecodeError, EncodeError, InkCodecs, LangError, MetadataError, NetworkError, SignerError, TimeoutError, TransactionError, applyGasMargin, buildAllEventDecoders, buildAllMessageDecoders, buildEventDecoder, buildMessageDecoder, compareGasWeight, createAsciiEventTopic, createCodecRegistry, createContractEventStream, createD9InkContract, createD9InkSdk, createMessageBuilder, createNativeTransferStream, createPSP22TransferStream, createTypedRpc, decodeContractCallResult, decodeInkValue, encodeCall, encodeContractCall, encodeContractCallWithLimits, estimateTransactionCost, formatGasInfo, gasExceedsLimit, getEventSignature, isCallType, isContractError, isErrorType, isEventType, isLangError, unwrapInkResult };
 //# sourceMappingURL=index.mjs.map