@alephium/web3 0.2.2 → 0.3.0-rc.1

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

@@ -347,7 +347,7 @@ export interface CompilerOptions {
     ignoreUnusedFieldsWarnings?: boolean;
     ignoreUnusedPrivateFunctionsWarnings?: boolean;
     ignoreUpdateFieldsCheckWarnings?: boolean;
-    ignoreExternalCallCheckWarnings?: boolean;
+    ignoreCheckExternalCallerWarnings?: boolean;
 }
 export interface Confirmed {
     /** @format block-hash */
@@ -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/contract/contract.js

@@ -66,7 +66,7 @@ exports.DEFAULT_NODE_COMPILER_OPTIONS = {
     ignoreUnusedFieldsWarnings: false,
     ignoreUnusedPrivateFunctionsWarnings: false,
     ignoreUpdateFieldsCheckWarnings: false,
-    ignoreExternalCallCheckWarnings: false
+    ignoreCheckExternalCallerWarnings: false
 };
 exports.DEFAULT_COMPILER_OPTIONS = { errorOnWarnings: true, ...exports.DEFAULT_NODE_COMPILER_OPTIONS };
 class TypedMatcher {

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

@@ -1,5 +1,10 @@
 import { ec as EC, SignatureInput } from 'elliptic';
-export declare function signatureEncode(signature: EC.Signature): string;
+import BN from 'bn.js';
+export declare function encodeSignature(signature: EC.Signature | {
+    r: BN;
+    s: BN;
+}): string;
+export declare function encodeHexSignature(rHex: string, sHex: string): string;
 export declare function signatureDecode(ec: EC, signature: string): SignatureInput;
 export declare function xorByte(intValue: number): number;
 export declare function isHexString(input: string): boolean;
@@ -13,7 +18,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

@@ -20,7 +20,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.assertType = exports.timeout = exports.hexToString = exports.stringToHex = exports.subContractId = exports.contractIdFromTx = exports.addressFromContractId = exports.addressFromPublicKey = exports.publicKeyFromPrivateKey = exports.groupOfPrivateKey = exports.binToHex = exports.hexToBinUnsafe = exports.tokenIdFromAddress = exports.contractIdFromAddress = exports.groupOfAddress = exports.isHexString = exports.xorByte = exports.signatureDecode = exports.signatureEncode = void 0;
+exports.assertType = exports.timeout = exports.hexToString = exports.stringToHex = exports.subContractId = exports.contractIdFromTx = exports.addressFromContractId = exports.addressFromPublicKey = exports.publicKeyFromPrivateKey = exports.groupOfPrivateKey = exports.binToHex = exports.hexToBinUnsafe = exports.tokenIdFromAddress = exports.contractIdFromAddress = exports.groupOfAddress = exports.isHexString = exports.xorByte = exports.signatureDecode = exports.encodeHexSignature = exports.encodeSignature = void 0;
 const elliptic_1 = require("elliptic");
 const bn_js_1 = __importDefault(require("bn.js"));
 const blakejs_1 = __importDefault(require("blakejs"));
@@ -29,7 +29,7 @@ const buffer_1 = require("buffer/");
 const constants_1 = require("../constants");
 const djb2_1 = __importDefault(require("./djb2"));
 const ec = new elliptic_1.ec('secp256k1');
-function signatureEncode(signature) {
+function encodeSignature(signature) {
     let sNormalized = signature.s;
     if (ec.n && signature.s.cmp(ec.nh) === 1) {
         sNormalized = ec.n.sub(signature.s);
@@ -38,7 +38,11 @@ function signatureEncode(signature) {
     const s = sNormalized.toString('hex', 66).slice(2);
     return r + s;
 }
-exports.signatureEncode = signatureEncode;
+exports.encodeSignature = encodeSignature;
+function encodeHexSignature(rHex, sHex) {
+    return encodeSignature({ r: new bn_js_1.default(rHex, 'hex'), s: new bn_js_1.default(sHex, 'hex') });
+}
+exports.encodeHexSignature = encodeHexSignature;
 // the signature should be in hex string format for 64 bytes
 function signatureDecode(ec, signature) {
     if (signature.length !== 128) {
@@ -64,7 +68,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 +181,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.1",
   "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-rc5",
+    "explorer_backend_version": "1.11.2"
   },
   "scripts": {
     "build": "rm -rf dist/* && npx tsc --build . && webpack",
@@ -49,6 +49,7 @@
   },
   "devDependencies": {
     "@babel/eslint-parser": "^7.18.9",
+    "@types/elliptic": "^6.4.13",
     "@types/find-up": "^2.1.0",
     "@types/fs-extra": "^9.0.13",
     "@types/jest": "^27.5.1",

package/src/api/api-alephium.ts

@@ -472,7 +472,7 @@ export interface CompilerOptions {
   ignoreUnusedFieldsWarnings?: boolean
   ignoreUnusedPrivateFunctionsWarnings?: boolean
   ignoreUpdateFieldsCheckWarnings?: boolean
-  ignoreExternalCallCheckWarnings?: boolean
+  ignoreCheckExternalCallerWarnings?: boolean
 }
 
 export interface Confirmed {
@@ -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/contract/contract.ts

@@ -70,7 +70,7 @@ export const DEFAULT_NODE_COMPILER_OPTIONS: node.CompilerOptions = {
   ignoreUnusedFieldsWarnings: false,
   ignoreUnusedPrivateFunctionsWarnings: false,
   ignoreUpdateFieldsCheckWarnings: false,
-  ignoreExternalCallCheckWarnings: false
+  ignoreCheckExternalCallerWarnings: false
 }
 
 export const DEFAULT_COMPILER_OPTIONS: CompilerOptions = { errorOnWarnings: true, ...DEFAULT_NODE_COMPILER_OPTIONS }

package/src/utils/utils.ts

@@ -27,7 +27,7 @@ import djb2 from './djb2'
 
 const ec = new EC('secp256k1')
 
-export function signatureEncode(signature: EC.Signature): string {
+export function encodeSignature(signature: EC.Signature | { r: BN; s: BN }): string {
   let sNormalized = signature.s
   if (ec.n && signature.s.cmp(ec.nh) === 1) {
     sNormalized = ec.n.sub(signature.s)
@@ -38,6 +38,10 @@ export function signatureEncode(signature: EC.Signature): string {
   return r + s
 }
 
+export function encodeHexSignature(rHex: string, sHex: string): string {
+  return encodeSignature({ r: new BN(rHex, 'hex'), s: new BN(sHex, 'hex') })
+}
+
 // the signature should be in hex string format for 64 bytes
 export function signatureDecode(ec: EC, signature: string): SignatureInput {
   if (signature.length !== 128) {
@@ -63,7 +67,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 +185,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 {