@alephium/web3 2.0.8 → 2.0.11

package/dist/src/api/api-alephium.d.ts

@@ -646,6 +646,8 @@ export interface ContractEvent {
     blockHash: string;
     /** @format 32-byte-hash */
     txId: string;
+    /** @format int64 */
+    timestamp: number;
     /** @format int32 */
     eventIndex: number;
     fields: Val[];
@@ -654,6 +656,8 @@ export interface ContractEvent {
 export interface ContractEventByBlockHash {
     /** @format 32-byte-hash */
     txId: string;
+    /** @format int64 */
+    timestamp: number;
     /** @format address */
     contractAddress: string;
     /** @format int32 */
@@ -664,6 +668,8 @@ export interface ContractEventByBlockHash {
 export interface ContractEventByTxId {
     /** @format block-hash */
     blockHash: string;
+    /** @format int64 */
+    timestamp: number;
     /** @format address */
     contractAddress: string;
     /** @format int32 */
@@ -1331,7 +1337,7 @@ export interface ValByteVec {
 }
 /** ValI256 */
 export interface ValI256 {
-    /** @format bigint */
+    /** @format int256 */
     value: string;
     type: string;
 }
@@ -1446,7 +1452,7 @@ export declare class HttpClient<SecurityDataType = unknown> {
 }
 /**
  * @title Alephium API
- * @version 4.2.5
+ * @version 4.4.1
  * @baseUrl ../
  */
 export declare class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDataType> {

package/dist/src/api/api-alephium.js

@@ -151,7 +151,7 @@ class HttpClient {
 exports.HttpClient = HttpClient;
 /**
  * @title Alephium API
- * @version 4.2.5
+ * @version 4.4.1
  * @baseUrl ../
  */
 class Api extends HttpClient {

package/dist/src/contract/contract.d.ts

@@ -148,6 +148,7 @@ export interface TestContractParams<F extends Fields = Fields, A extends Argumen
 export interface ContractEvent<T extends Fields = Fields> {
     txId: string;
     blockHash: string;
+    timestamp: number;
     contractAddress: string;
     eventIndex: number;
     name: string;

package/dist/src/contract/contract.js

@@ -359,6 +359,7 @@ class Contract extends Artifact {
         return {
             txId: txId,
             blockHash: event.blockHash,
+            timestamp: event.timestamp,
             contractAddress: event.contractAddress,
             name: name,
             eventIndex: event.eventIndex,
@@ -792,6 +793,7 @@ function decodeContractCreatedEvent(event) {
     return {
         blockHash: event.blockHash,
         txId: event.txId,
+        timestamp: event.timestamp,
         eventIndex: event.eventIndex,
         name: Contract.ContractCreatedEvent.name,
         fields: toContractCreatedEventFields(fields)
@@ -803,6 +805,7 @@ function decodeContractDestroyedEvent(event) {
     return {
         blockHash: event.blockHash,
         txId: event.txId,
+        timestamp: event.timestamp,
         eventIndex: event.eventIndex,
         name: Contract.ContractDestroyedEvent.name,
         fields: { address: fields['address'] }
@@ -1252,13 +1255,39 @@ exports.subscribeContractEvents = subscribeContractEvents;
 async function callMethod(contract, instance, methodName, params, getContractByCodeHash) {
     const methodIndex = contract.contract.getMethodIndex(methodName);
     const txId = params?.txId ?? randomTxId();
-    const callParams = contract.contract.toApiCallContract({ ...params, txId: txId, args: params.args === undefined ? {} : params.args }, instance.groupIndex, instance.address, methodIndex);
+    const callArgs = getCallMethodArgs(params.args ?? {}, instance.groupIndex);
+    const callParams = contract.contract.toApiCallContract({ ...params, txId: txId, args: callArgs }, instance.groupIndex, instance.address, methodIndex);
     const result = await (0, global_1.getCurrentNodeProvider)().contracts.postContractsCallContract(callParams);
     const callResult = contract.contract.fromApiCallContractResult(result, txId, methodIndex, getContractByCodeHash);
     contract.contract.printDebugMessages(methodName, callResult.debugMessages);
     return callResult;
 }
 exports.callMethod = callMethod;
+function tryGetCallMethodAddressArg(maybeAddress, groupIndex) {
+    if (!(0, address_1.isValidAddress)(maybeAddress))
+        return maybeAddress;
+    if ((0, address_1.isGrouplessAddress)(maybeAddress)) {
+        const rawAddress = (0, address_1.addressWithoutExplicitGroupIndex)(maybeAddress);
+        return `${rawAddress}:${groupIndex}`;
+    }
+    return maybeAddress;
+}
+function getCallMethodArgsFromVal(val, groupIndex) {
+    if (typeof val === 'string') {
+        return tryGetCallMethodAddressArg(val, groupIndex);
+    }
+    if (Array.isArray(val)) {
+        return val.map((v) => getCallMethodArgsFromVal(v, groupIndex));
+    }
+    return val;
+}
+function getCallMethodArgs(args, groupIndex) {
+    const newArgs = {};
+    for (const [key, value] of Object.entries(args)) {
+        newArgs[`${key}`] = getCallMethodArgsFromVal(value, groupIndex);
+    }
+    return newArgs;
+}
 async function signExecuteMethod(contract, instance, methodName, params) {
     const methodIndex = contract.contract.getMethodIndex(methodName);
     const functionSig = contract.contract.functions[methodIndex];
@@ -1451,7 +1480,8 @@ async function multicallMethods(contract, instance, _callss, getContractByCodeHa
             const [methodName, params] = entry;
             const methodIndex = contract.contract.getMethodIndex(methodName);
             const txId = params?.txId ?? randomTxId();
-            return contract.contract.toApiCallContract({ ...params, txId: txId, args: params.args === undefined ? {} : params.args }, instance.groupIndex, instance.address, methodIndex);
+            const callArgs = getCallMethodArgs(params.args ?? {}, instance.groupIndex);
+            return contract.contract.toApiCallContract({ ...params, txId: txId, args: callArgs }, instance.groupIndex, instance.address, methodIndex);
         });
     });
     const result = await (0, global_1.getCurrentNodeProvider)().contracts.postContractsMulticallContract({ calls: callsParams.flat() });

package/dist/src/utils/webcrypto.js

@@ -29,7 +29,8 @@ class WebCrypto {
             throw new TypeError("Failed to execute 'getRandomValues' on 'Crypto': parameter 1 is not of type 'ArrayBufferView'");
         }
         const bytes = new Uint8Array(array.buffer, array.byteOffset, array.byteLength);
-        if (isBrowser) {
+        // Prefer global Web Crypto (e.g. react-native-get-random-values) for mobile compatibility
+        if (globalThis.crypto && typeof globalThis.crypto.getRandomValues === 'function') {
             globalThis.crypto.getRandomValues(bytes);
         }
         else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alephium/web3",
-  "version": "2.0.8",
+  "version": "2.0.11",
   "description": "A JS/TS library to interact with the Alephium platform",
   "license": "GPL",
   "main": "dist/src/index.js",
@@ -25,7 +25,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git@github.com:alephium/alephium-web3.git"
+    "url": "git+https://github.com/alephium/alephium-web3.git"
   },
   "homepage": "https://github.com/alephium/alephium-web3",
   "bugs": {
@@ -33,7 +33,7 @@
   },
   "author": "Alephium dev <dev@alephium.org>",
   "config": {
-    "alephium_version": "4.2.5",
+    "alephium_version": "4.4.1",
     "explorer_backend_version": "3.3.2"
   },
   "type": "commonjs",

package/src/api/api-alephium.ts

@@ -723,6 +723,8 @@ export interface ContractEvent {
   blockHash: string
   /** @format 32-byte-hash */
   txId: string
+  /** @format int64 */
+  timestamp: number
   /** @format int32 */
   eventIndex: number
   fields: Val[]
@@ -732,6 +734,8 @@ export interface ContractEvent {
 export interface ContractEventByBlockHash {
   /** @format 32-byte-hash */
   txId: string
+  /** @format int64 */
+  timestamp: number
   /** @format address */
   contractAddress: string
   /** @format int32 */
@@ -743,6 +747,8 @@ export interface ContractEventByBlockHash {
 export interface ContractEventByTxId {
   /** @format block-hash */
   blockHash: string
+  /** @format int64 */
+  timestamp: number
   /** @format address */
   contractAddress: string
   /** @format int32 */
@@ -1503,7 +1509,7 @@ export interface ValByteVec {
 
 /** ValI256 */
 export interface ValI256 {
-  /** @format bigint */
+  /** @format int256 */
   value: string
   type: string
 }
@@ -1780,7 +1786,7 @@ export class HttpClient<SecurityDataType = unknown> {
 
 /**
  * @title Alephium API
- * @version 4.2.5
+ * @version 4.4.1
  * @baseUrl ../
  */
 export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDataType> {

package/src/contract/contract.ts

@@ -59,7 +59,15 @@ import {
   isHexString,
   hexToString
 } from '../utils'
-import { contractIdFromAddress, groupOfAddress, addressFromContractId, subContractId } from '../address'
+import {
+  contractIdFromAddress,
+  groupOfAddress,
+  addressFromContractId,
+  subContractId,
+  isGrouplessAddress,
+  isValidAddress,
+  addressWithoutExplicitGroupIndex
+} from '../address'
 import { getCurrentNodeProvider } from '../global'
 import { EventSubscribeOptions, EventSubscription, subscribeToEvents } from './events'
 import { MINIMAL_CONTRACT_DEPOSIT, ONE_ALPH, TOTAL_NUMBER_OF_GROUPS } from '../constants'
@@ -559,6 +567,7 @@ export class Contract extends Artifact {
     return {
       txId: txId,
       blockHash: event.blockHash,
+      timestamp: event.timestamp,
       contractAddress: event.contractAddress,
       name: name,
       eventIndex: event.eventIndex,
@@ -1001,6 +1010,7 @@ export interface TestContractParams<
 export interface ContractEvent<T extends Fields = Fields> {
   txId: string
   blockHash: string
+  timestamp: number
   contractAddress: string
   eventIndex: number
   name: string
@@ -1294,6 +1304,7 @@ export function decodeContractCreatedEvent(event: node.ContractEvent): Omit<Cont
   return {
     blockHash: event.blockHash,
     txId: event.txId,
+    timestamp: event.timestamp,
     eventIndex: event.eventIndex,
     name: Contract.ContractCreatedEvent.name,
     fields: toContractCreatedEventFields(fields)
@@ -1307,6 +1318,7 @@ export function decodeContractDestroyedEvent(
   return {
     blockHash: event.blockHash,
     txId: event.txId,
+    timestamp: event.timestamp,
     eventIndex: event.eventIndex,
     name: Contract.ContractDestroyedEvent.name,
     fields: { address: fields['address'] as Address }
@@ -1923,8 +1935,9 @@ export async function callMethod<I extends ContractInstance, F extends Fields, A
 ): Promise<CallContractResult<R>> {
   const methodIndex = contract.contract.getMethodIndex(methodName)
   const txId = params?.txId ?? randomTxId()
+  const callArgs = getCallMethodArgs(params.args ?? {}, instance.groupIndex)
   const callParams = contract.contract.toApiCallContract(
-    { ...params, txId: txId, args: params.args === undefined ? {} : params.args },
+    { ...params, txId: txId, args: callArgs },
     instance.groupIndex,
     instance.address,
     methodIndex
@@ -1935,6 +1948,33 @@ export async function callMethod<I extends ContractInstance, F extends Fields, A
   return callResult as CallContractResult<R>
 }
 
+function tryGetCallMethodAddressArg(maybeAddress: string, groupIndex: number): Val {
+  if (!isValidAddress(maybeAddress)) return maybeAddress
+  if (isGrouplessAddress(maybeAddress)) {
+    const rawAddress = addressWithoutExplicitGroupIndex(maybeAddress)
+    return `${rawAddress}:${groupIndex}`
+  }
+  return maybeAddress
+}
+
+function getCallMethodArgsFromVal(val: Val, groupIndex: number): Val {
+  if (typeof val === 'string') {
+    return tryGetCallMethodAddressArg(val, groupIndex)
+  }
+  if (Array.isArray(val)) {
+    return val.map((v) => getCallMethodArgsFromVal(v, groupIndex))
+  }
+  return val
+}
+
+function getCallMethodArgs<A extends Arguments>(args: A, groupIndex: number): A {
+  const newArgs: Arguments = {}
+  for (const [key, value] of Object.entries(args)) {
+    newArgs[`${key}`] = getCallMethodArgsFromVal(value, groupIndex)
+  }
+  return newArgs as A
+}
+
 export async function signExecuteMethod<I extends ContractInstance, F extends Fields, A extends Arguments, R>(
   contract: ContractFactory<I, F>,
   instance: ContractInstance,
@@ -2199,8 +2239,9 @@ export async function multicallMethods<I extends ContractInstance, F extends Fie
       const [methodName, params] = entry
       const methodIndex = contract.contract.getMethodIndex(methodName)
       const txId = params?.txId ?? randomTxId()
+      const callArgs = getCallMethodArgs(params.args ?? {}, instance.groupIndex)
       return contract.contract.toApiCallContract(
-        { ...params, txId: txId, args: params.args === undefined ? {} : params.args },
+        { ...params, txId: txId, args: callArgs },
         instance.groupIndex,
         instance.address,
         methodIndex

package/src/utils/webcrypto.ts

@@ -31,7 +31,8 @@ export class WebCrypto {
     }
     const bytes = new Uint8Array(array.buffer, array.byteOffset, array.byteLength)
 
-    if (isBrowser) {
+    // Prefer global Web Crypto (e.g. react-native-get-random-values) for mobile compatibility
+    if (globalThis.crypto && typeof globalThis.crypto.getRandomValues === 'function') {
       globalThis.crypto.getRandomValues(bytes)
     } else {
       randomFillSync(bytes)