@alephium/web3 0.2.2 → 0.3.0-rc.0

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

@@ -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.3
+ * @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.3
+ * @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/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.2",
+  "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.3",
-    "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

@@ -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.3
+ * @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/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 {