@alephium/web3 0.2.0 → 0.3.0-rc.0

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

@@ -346,7 +346,7 @@ export interface CompilerOptions {
     ignoreUnusedVariablesWarnings?: boolean;
     ignoreUnusedFieldsWarnings?: boolean;
     ignoreUnusedPrivateFunctionsWarnings?: boolean;
-    ignoreReadonlyCheckWarnings?: boolean;
+    ignoreUpdateFieldsCheckWarnings?: boolean;
     ignoreExternalCallCheckWarnings?: boolean;
 }
 export interface Confirmed {
@@ -737,11 +737,11 @@ export interface UTXO {
     ref: OutputRef;
     /** @format uint256 */
     amount: string;
-    tokens: Token[];
+    tokens?: Token[];
     /** @format int64 */
-    lockTime: number;
+    lockTime?: number;
     /** @format hex-string */
-    additionalData: string;
+    additionalData?: string;
 }
 export interface UTXOs {
     utxos: UTXO[];
@@ -908,7 +908,7 @@ export declare class HttpClient<SecurityDataType = unknown> {
 }
 /**
  * @title Alephium API
- * @version 1.5.0
+ * @version 1.6.0
  * @baseUrl ../
  */
 export declare class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDataType> {

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

@@ -149,7 +149,7 @@ class HttpClient {
 exports.HttpClient = HttpClient;
 /**
  * @title Alephium API
- * @version 1.5.0
+ * @version 1.6.0
  * @baseUrl ../
  */
 class Api extends HttpClient {

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

@@ -91,6 +91,8 @@ export interface Input {
     outputRef: OutputRef;
     /** @format hex-string */
     unlockScript?: string;
+    /** @format 32-byte-hash */
+    txHashRef?: string;
     address?: string;
     /** @format uint256 */
     attoAlphAmount?: string;
@@ -352,6 +354,18 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
             limit?: number;
             reverse?: boolean;
         }, params?: RequestParams) => Promise<Transaction[]>;
+        /**
+         * @description List transactions for given addresses
+         *
+         * @tags Addresses
+         * @name PostAddressesTransactions
+         * @request POST:/addresses/transactions
+         */
+        postAddressesTransactions: (query?: {
+            page?: number;
+            limit?: number;
+            reverse?: boolean;
+        }, data?: string[], params?: RequestParams) => Promise<Transaction[]>;
         /**
          * @description List transactions of a given address within a time-range
          *
@@ -418,6 +432,17 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @request GET:/addresses/{address}/tokens/{token_id}/balance
          */
         getAddressesAddressTokensTokenIdBalance: (address: string, tokenId: string, params?: RequestParams) => Promise<AddressBalance>;
+        /**
+         * No description
+         *
+         * @tags Addresses
+         * @name GetAddressesAddressExportTransactionsCsv
+         * @request GET:/addresses/{address}/export-transactions/csv
+         */
+        getAddressesAddressExportTransactionsCsv: (address: string, query: {
+            fromTs: number;
+            toTs: number;
+        }, params?: RequestParams) => Promise<string>;
     };
     addressesActive: {
         /**

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

@@ -253,6 +253,22 @@ class Api extends HttpClient {
                 format: 'json',
                 ...params
             }).then(utils_1.convertHttpResponse),
+            /**
+             * @description List transactions for given addresses
+             *
+             * @tags Addresses
+             * @name PostAddressesTransactions
+             * @request POST:/addresses/transactions
+             */
+            postAddressesTransactions: (query, data, params = {}) => this.request({
+                path: `/addresses/transactions`,
+                method: 'POST',
+                query: query,
+                body: data,
+                type: ContentType.Json,
+                format: 'json',
+                ...params
+            }).then(utils_1.convertHttpResponse),
             /**
              * @description List transactions of a given address within a time-range
              *
@@ -345,6 +361,19 @@ class Api extends HttpClient {
                 method: 'GET',
                 format: 'json',
                 ...params
+            }).then(utils_1.convertHttpResponse),
+            /**
+             * No description
+             *
+             * @tags Addresses
+             * @name GetAddressesAddressExportTransactionsCsv
+             * @request GET:/addresses/{address}/export-transactions/csv
+             */
+            getAddressesAddressExportTransactionsCsv: (address, query, params = {}) => this.request({
+                path: `/addresses/${address}/export-transactions/csv`,
+                method: 'GET',
+                query: query,
+                ...params
             }).then(utils_1.convertHttpResponse)
         };
         this.addressesActive = {

package/dist/src/constants.d.ts

@@ -1,2 +1,3 @@
 export declare const TOTAL_NUMBER_OF_GROUPS = 4;
 export declare const MIN_UTXO_SET_AMOUNT: bigint;
+export declare const ALPH_TOKEN_ID: string;

package/dist/src/constants.js

@@ -17,6 +17,7 @@ You should have received a copy of the GNU Lesser General Public License
 along with the library. If not, see <http://www.gnu.org/licenses/>.
 */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MIN_UTXO_SET_AMOUNT = exports.TOTAL_NUMBER_OF_GROUPS = void 0;
+exports.ALPH_TOKEN_ID = exports.MIN_UTXO_SET_AMOUNT = exports.TOTAL_NUMBER_OF_GROUPS = void 0;
 exports.TOTAL_NUMBER_OF_GROUPS = 4;
 exports.MIN_UTXO_SET_AMOUNT = BigInt(1000000000000);
+exports.ALPH_TOKEN_ID = ''.padStart(64, '0');

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

@@ -118,6 +118,7 @@ export declare class Contract extends Artifact {
     toApiContractStates(states?: ContractState[]): node.ContractState[] | undefined;
     toTestContract(funcName: string, params: TestContractParams): node.TestContract;
     fromApiContractState(state: node.ContractState): ContractState;
+    static fromApiContractState(state: node.ContractState): ContractState;
     static ContractCreatedEvent: EventSig;
     static ContractDestroyedEvent: EventSig;
     static fromApiEvent(event: node.ContractEventByTxId, codeHash: string | undefined): ContractEventByTxId;

package/dist/src/contract/contract.js

@@ -65,7 +65,7 @@ exports.DEFAULT_NODE_COMPILER_OPTIONS = {
     ignoreUnusedVariablesWarnings: false,
     ignoreUnusedFieldsWarnings: false,
     ignoreUnusedPrivateFunctionsWarnings: false,
-    ignoreReadonlyCheckWarnings: false,
+    ignoreUpdateFieldsCheckWarnings: false,
     ignoreExternalCallCheckWarnings: false
 };
 exports.DEFAULT_COMPILER_OPTIONS = { errorOnWarnings: true, ...exports.DEFAULT_NODE_COMPILER_OPTIONS };
@@ -530,18 +530,21 @@ class Contract extends Artifact {
         };
     }
     fromApiContractState(state) {
-        const contract = Project.currentProject.contractByCodeHash(state.codeHash);
         return {
             address: state.address,
             contractId: (0, utils_1.binToHex)((0, utils_1.contractIdFromAddress)(state.address)),
             bytecode: state.bytecode,
             initialStateHash: state.initialStateHash,
             codeHash: state.codeHash,
-            fields: fromApiFields(state.fields, contract.fieldsSig),
-            fieldsSig: contract.fieldsSig,
+            fields: fromApiFields(state.fields, this.fieldsSig),
+            fieldsSig: this.fieldsSig,
             asset: fromApiAsset(state.asset)
         };
     }
+    static fromApiContractState(state) {
+        const contract = Project.currentProject.contractByCodeHash(state.codeHash);
+        return contract.fromApiContractState(state);
+    }
     static fromApiEvent(event, codeHash) {
         let eventSig;
         if (event.eventIndex == -1) {
@@ -570,7 +573,7 @@ class Contract extends Artifact {
             contractAddress: result.address,
             returns: (0, api_1.fromApiArray)(result.returns, this.functions[`${methodIndex}`].returnTypes),
             gasUsed: result.gasUsed,
-            contracts: result.contracts.map((contract) => this.fromApiContractState(contract)),
+            contracts: result.contracts.map((contract) => Contract.fromApiContractState(contract)),
             txOutputs: result.txOutputs.map(fromApiOutput),
             events: result.events.map((event) => {
                 const contractAddress = event.contractAddress;

package/dist/src/utils/utils.d.ts

@@ -13,7 +13,7 @@ export declare function publicKeyFromPrivateKey(privateKey: string): string;
 export declare function addressFromPublicKey(publicKey: string): string;
 export declare function addressFromContractId(contractId: string): string;
 export declare function contractIdFromTx(txId: string, outputIndex: number): string;
-export declare function subContractId(parentContractId: string, pathInHex: string): string;
+export declare function subContractId(parentContractId: string, pathInHex: string, group: number): string;
 export declare function stringToHex(str: string): string;
 export declare function hexToString(str: string): string;
 export declare function timeout(ms: number): Promise<void>;

package/dist/src/utils/utils.js

@@ -64,7 +64,7 @@ function xorByte(intValue) {
 }
 exports.xorByte = xorByte;
 function isHexString(input) {
-    return input.length % 2 === 0 && /[0-9a-f]*$/.test(input);
+    return input.length % 2 === 0 && /^[0-9a-fA-F]*$/.test(input);
 }
 exports.isHexString = isHexString;
 var AddressType;
@@ -177,9 +177,16 @@ function contractIdFromTx(txId, outputIndex) {
     return binToHex(hash);
 }
 exports.contractIdFromTx = contractIdFromTx;
-function subContractId(parentContractId, pathInHex) {
+function subContractId(parentContractId, pathInHex, group) {
+    if (group < 0 || group >= constants_1.TOTAL_NUMBER_OF_GROUPS) {
+        throw new Error(`Invalid group ${group}`);
+    }
     const data = buffer_1.Buffer.concat([hexToBinUnsafe(parentContractId), hexToBinUnsafe(pathInHex)]);
-    return binToHex(blakejs_1.default.blake2b(blakejs_1.default.blake2b(data, undefined, 32), undefined, 32));
+    const bytes = buffer_1.Buffer.concat([
+        blakejs_1.default.blake2b(blakejs_1.default.blake2b(data, undefined, 32), undefined, 32).slice(0, -1),
+        buffer_1.Buffer.from([group])
+    ]);
+    return binToHex(bytes);
 }
 exports.subContractId = subContractId;
 function stringToHex(str) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alephium/web3",
-  "version": "0.2.0",
+  "version": "0.3.0-rc.0",
   "description": "A JS/TS library to interact with the Alephium platform",
   "license": "GPL",
   "main": "dist/src/index.js",
@@ -27,8 +27,8 @@
   },
   "author": "Alephium dev <dev@alephium.org>",
   "config": {
-    "alephium_version": "1.5.0",
-    "explorer_backend_version": "1.9.0"
+    "alephium_version": "1.6.0-rc0",
+    "explorer_backend_version": "1.11.2"
   },
   "scripts": {
     "build": "rm -rf dist/* && npx tsc --build . && webpack",

package/src/api/api-alephium.ts

@@ -471,7 +471,7 @@ export interface CompilerOptions {
   ignoreUnusedVariablesWarnings?: boolean
   ignoreUnusedFieldsWarnings?: boolean
   ignoreUnusedPrivateFunctionsWarnings?: boolean
-  ignoreReadonlyCheckWarnings?: boolean
+  ignoreUpdateFieldsCheckWarnings?: boolean
   ignoreExternalCallCheckWarnings?: boolean
 }
 
@@ -979,13 +979,13 @@ export interface UTXO {
 
   /** @format uint256 */
   amount: string
-  tokens: Token[]
+  tokens?: Token[]
 
   /** @format int64 */
-  lockTime: number
+  lockTime?: number
 
   /** @format hex-string */
-  additionalData: string
+  additionalData?: string
 }
 
 export interface UTXOs {
@@ -1332,7 +1332,7 @@ export class HttpClient<SecurityDataType = unknown> {
 
 /**
  * @title Alephium API
- * @version 1.5.0
+ * @version 1.6.0
  * @baseUrl ../
  */
 export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDataType> {

package/src/api/api-explorer.ts

@@ -133,6 +133,9 @@ export interface Input {
 
   /** @format hex-string */
   unlockScript?: string
+
+  /** @format 32-byte-hash */
+  txHashRef?: string
   address?: string
 
   /** @format uint256 */
@@ -637,6 +640,28 @@ export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDa
         ...params
       }).then(convertHttpResponse),
 
+    /**
+     * @description List transactions for given addresses
+     *
+     * @tags Addresses
+     * @name PostAddressesTransactions
+     * @request POST:/addresses/transactions
+     */
+    postAddressesTransactions: (
+      query?: { page?: number; limit?: number; reverse?: boolean },
+      data?: string[],
+      params: RequestParams = {}
+    ) =>
+      this.request<Transaction[], BadRequest | Unauthorized | NotFound | InternalServerError | ServiceUnavailable>({
+        path: `/addresses/transactions`,
+        method: 'POST',
+        query: query,
+        body: data,
+        type: ContentType.Json,
+        format: 'json',
+        ...params
+      }).then(convertHttpResponse),
+
     /**
      * @description List transactions of a given address within a time-range
      *
@@ -751,6 +776,25 @@ export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDa
         method: 'GET',
         format: 'json',
         ...params
+      }).then(convertHttpResponse),
+
+    /**
+     * No description
+     *
+     * @tags Addresses
+     * @name GetAddressesAddressExportTransactionsCsv
+     * @request GET:/addresses/{address}/export-transactions/csv
+     */
+    getAddressesAddressExportTransactionsCsv: (
+      address: string,
+      query: { fromTs: number; toTs: number },
+      params: RequestParams = {}
+    ) =>
+      this.request<string, BadRequest | Unauthorized | NotFound | InternalServerError | ServiceUnavailable>({
+        path: `/addresses/${address}/export-transactions/csv`,
+        method: 'GET',
+        query: query,
+        ...params
       }).then(convertHttpResponse)
   }
   addressesActive = {

package/src/constants.ts

@@ -18,3 +18,4 @@ along with the library. If not, see <http://www.gnu.org/licenses/>.
 
 export const TOTAL_NUMBER_OF_GROUPS = 4
 export const MIN_UTXO_SET_AMOUNT = BigInt(1000000000000)
+export const ALPH_TOKEN_ID = ''.padStart(64, '0')

package/src/contract/contract.ts

@@ -69,7 +69,7 @@ export const DEFAULT_NODE_COMPILER_OPTIONS: node.CompilerOptions = {
   ignoreUnusedVariablesWarnings: false,
   ignoreUnusedFieldsWarnings: false,
   ignoreUnusedPrivateFunctionsWarnings: false,
-  ignoreReadonlyCheckWarnings: false,
+  ignoreUpdateFieldsCheckWarnings: false,
   ignoreExternalCallCheckWarnings: false
 }
 
@@ -746,19 +746,23 @@ export class Contract extends Artifact {
   }
 
   fromApiContractState(state: node.ContractState): ContractState {
-    const contract = Project.currentProject.contractByCodeHash(state.codeHash)
     return {
       address: state.address,
       contractId: binToHex(contractIdFromAddress(state.address)),
       bytecode: state.bytecode,
       initialStateHash: state.initialStateHash,
       codeHash: state.codeHash,
-      fields: fromApiFields(state.fields, contract.fieldsSig),
-      fieldsSig: contract.fieldsSig,
+      fields: fromApiFields(state.fields, this.fieldsSig),
+      fieldsSig: this.fieldsSig,
       asset: fromApiAsset(state.asset)
     }
   }
 
+  static fromApiContractState(state: node.ContractState): ContractState {
+    const contract = Project.currentProject.contractByCodeHash(state.codeHash)
+    return contract.fromApiContractState(state)
+  }
+
   static ContractCreatedEvent: EventSig = {
     name: 'ContractCreated',
     fieldNames: ['address'],
@@ -800,7 +804,7 @@ export class Contract extends Artifact {
       contractAddress: result.address,
       returns: fromApiArray(result.returns, this.functions[`${methodIndex}`].returnTypes),
       gasUsed: result.gasUsed,
-      contracts: result.contracts.map((contract) => this.fromApiContractState(contract)),
+      contracts: result.contracts.map((contract) => Contract.fromApiContractState(contract)),
       txOutputs: result.txOutputs.map(fromApiOutput),
       events: result.events.map((event) => {
         const contractAddress = event.contractAddress

package/src/utils/utils.ts

@@ -63,7 +63,7 @@ export function xorByte(intValue: number): number {
 }
 
 export function isHexString(input: string): boolean {
-  return input.length % 2 === 0 && /[0-9a-f]*$/.test(input)
+  return input.length % 2 === 0 && /^[0-9a-fA-F]*$/.test(input)
 }
 
 enum AddressType {
@@ -181,10 +181,16 @@ export function contractIdFromTx(txId: string, outputIndex: number): string {
   return binToHex(hash)
 }
 
-export function subContractId(parentContractId: string, pathInHex: string): string {
+export function subContractId(parentContractId: string, pathInHex: string, group: number): string {
+  if (group < 0 || group >= TOTAL_NUMBER_OF_GROUPS) {
+    throw new Error(`Invalid group ${group}`)
+  }
   const data = Buffer.concat([hexToBinUnsafe(parentContractId), hexToBinUnsafe(pathInHex)])
-
-  return binToHex(blake.blake2b(blake.blake2b(data, undefined, 32), undefined, 32))
+  const bytes = Buffer.concat([
+    blake.blake2b(blake.blake2b(data, undefined, 32), undefined, 32).slice(0, -1),
+    Buffer.from([group])
+  ])
+  return binToHex(bytes)
 }
 
 export function stringToHex(str: string): string {