@d9-network/spec 1.0.2 → 1.2.2

package/.papi/descriptors/.gitignore

@@ -0,0 +1,3 @@
+*
+!.gitignore
+!package.json

package/.papi/descriptors/package.json

@@ -0,0 +1,24 @@
+{
+  "version": "0.1.0-autogenerated.7179878986362617971",
+  "name": "@polkadot-api/descriptors",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "module": "./dist/index.mjs",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "browser": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "peerDependencies": {
+    "polkadot-api": ">=1.21.0"
+  }
+}

package/README.md

@@ -63,6 +63,18 @@ if (result.success) {
 | `parseAmount`    | Parse balance string to bigint   |
 | `isValidAddress` | Validate SS58 address            |
 
+### Byte Utilities
+
+| Export              | Description                           |
+| ------------------- | ------------------------------------- |
+| `hexToBytes`        | Convert hex string to Uint8Array      |
+| `bytesToHex`        | Convert Uint8Array to hex string      |
+| `concatBytes`       | Concatenate multiple Uint8Arrays      |
+| `bytesEqual`        | Compare two Uint8Arrays               |
+| `extractSelector`   | Extract 4-byte selector from calldata |
+| `extractSelectorHex`| Extract selector as hex string        |
+| `normalizeHex`      | Normalize hex string (0x prefix, lowercase) |
+
 ### Constants
 
 | Export           | Description                    |

package/dist/index.cjs

@@ -10629,6 +10629,112 @@ function formatBlockDuration(blocks, options = {}) {
 	return parts.slice(0, maxUnits).join(short ? " " : ", ");
 }
 
+//#endregion
+//#region src/utils/bytes.ts
+/**
+* Concatenate multiple Uint8Arrays into one
+*
+* @param arrays - Arrays to concatenate
+* @returns Combined Uint8Array
+*
+* @example
+* ```ts
+* const selector = hexToBytes("0xdb20f9f5");
+* const args = encodeArgs(...);
+* const callData = concatBytes(selector, args);
+* ```
+*/
+function concatBytes(...arrays) {
+	const totalLength = arrays.reduce((sum, arr$1) => sum + arr$1.length, 0);
+	const result = new Uint8Array(totalLength);
+	let offset = 0;
+	for (const arr$1 of arrays) {
+		result.set(arr$1, offset);
+		offset += arr$1.length;
+	}
+	return result;
+}
+/**
+* Compare two Uint8Arrays for equality
+*
+* @param a - First array
+* @param b - Second array
+* @returns True if arrays are equal
+*/
+function bytesEqual(a, b) {
+	if (a.length !== b.length) return false;
+	for (let i = 0; i < a.length; i++) if (a[i] !== b[i]) return false;
+	return true;
+}
+/**
+* Extract a slice from a Uint8Array with bounds checking
+*
+* @param data - Source array
+* @param start - Start index
+* @param length - Optional length (defaults to rest of array)
+* @returns Sliced array
+* @throws If indices are out of bounds
+*/
+function safeSlice(data, start, length) {
+	if (start < 0 || start > data.length) throw new RangeError(`Start index ${start} out of bounds (0-${data.length})`);
+	const end = length !== void 0 ? start + length : data.length;
+	if (end > data.length) throw new RangeError(`End index ${end} exceeds array length ${data.length}`);
+	return data.slice(start, end);
+}
+/**
+* Extract selector (first 4 bytes) from call data
+*
+* @param callData - The call data (Uint8Array or hex string)
+* @returns 4-byte selector
+* @throws If data is less than 4 bytes
+*
+* @example
+* ```ts
+* const selector = extractSelector(callData);
+* const selectorHex = bytesToHex(selector); // "0xdb20f9f5"
+* ```
+*/
+function extractSelector(callData) {
+	const bytes = callData instanceof Uint8Array ? callData : hexToBytes(callData);
+	if (bytes.length < 4) throw new Error(`Call data too short (${bytes.length} bytes), need at least 4 bytes for selector`);
+	return bytes.slice(0, 4);
+}
+/**
+* Extract selector as hex string from call data
+*
+* @param callData - The call data (Uint8Array or hex string)
+* @returns Hex string without 0x prefix (e.g., "db20f9f5")
+*
+* @example
+* ```ts
+* const selectorHex = extractSelectorHex(callData);
+* if (selectorHex === "db20f9f5") {
+*   // PSP22::transfer
+* }
+* ```
+*/
+function extractSelectorHex(callData) {
+	return bytesToHex(extractSelector(callData)).slice(2);
+}
+/**
+* Normalize a hex string (ensure 0x prefix, lowercase)
+*
+* @param hex - Hex string with or without 0x prefix
+* @returns Normalized hex string with 0x prefix
+*/
+function normalizeHex(hex$1) {
+	return `0x${(hex$1.startsWith("0x") ? hex$1.slice(2) : hex$1).toLowerCase()}`;
+}
+/**
+* Convert a selector string (with or without 0x) to Uint8Array
+*
+* @param selector - Selector as hex string
+* @returns 4-byte Uint8Array
+*/
+function selectorToBytes(selector) {
+	return hexToBytes(normalizeHex(selector));
+}
+
 //#endregion
 exports.AbortedError = AbortedError;
 exports.ArithmeticError = ArithmeticError;
@@ -10670,7 +10776,9 @@ exports.USDT_TOKEN = USDT_TOKEN;
 exports.addressesEqual = addressesEqual;
 exports.blocksToMs = blocksToMs;
 exports.blocksUntil = blocksUntil;
+exports.bytesEqual = bytesEqual;
 exports.bytesToHex = bytesToHex;
+exports.concatBytes = concatBytes;
 exports.contracts = contracts_exports;
 exports.createAccountFromMnemonic = createAccountFromMnemonic;
 exports.createAccountFromPrivateKey = createAccountFromPrivateKey;
@@ -10678,6 +10786,8 @@ exports.createSr25519SignerFromKeypair = createSr25519SignerFromKeypair;
 exports.d9 = d9_default;
 exports.estimateBlockAtTime = estimateBlockAtTime;
 exports.estimateTimeAtBlock = estimateTimeAtBlock;
+exports.extractSelector = extractSelector;
+exports.extractSelectorHex = extractSelectorHex;
 exports.formatBalance = formatBalance;
 exports.formatBlockDuration = formatBlockDuration;
 exports.formatTokenAmount = formatTokenAmount;
@@ -10693,7 +10803,10 @@ exports.isValidAddressForNetwork = isValidAddressForNetwork;
 exports.isValidD9Address = isValidD9Address;
 exports.mnemonicToMiniSecret = mnemonicToMiniSecret;
 exports.msToBlocks = msToBlocks;
+exports.normalizeHex = normalizeHex;
 exports.parseAmount = parseAmount;
+exports.safeSlice = safeSlice;
+exports.selectorToBytes = selectorToBytes;
 exports.sr25519AddressFromKeypair = sr25519AddressFromKeypair;
 exports.sr25519AddressFromSecretKeyHex = sr25519AddressFromSecretKeyHex;
 exports.sr25519DeriveFromMiniSecret = sr25519DeriveFromMiniSecret;