@alephium/web3 0.2.0-test.0 → 0.2.0-test.1

package/dist/scripts/create-project.js

@@ -86,7 +86,8 @@ function prepareShared(packageRoot, projectRoot) {
 }
 function prepareBase(packageRoot, projectRoot) {
     prepareShared(packageRoot, projectRoot);
-    copy('contracts', ['greeter.ral', 'greeter_interface.ral', 'greeter_main.ral']);
+    copy('contracts', ['greeter_main.ral']);
+    copy('contracts/greeter', ['greeter.ral', 'greeter_interface.ral']);
     fs_extra_1.default.copySync(path_1.default.join(packageRoot, 'templates/base'), projectRoot);
 }
 function prepareReact(packageRoot, projectRoot, projectName) {

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

@@ -148,6 +148,8 @@ export interface BuildDeployContractTx {
     gasAmount?: number;
     /** @format uint256 */
     gasPrice?: string;
+    /** @format block-hash */
+    targetBlockHash?: string;
 }
 export interface BuildDeployContractTxResult {
     /** @format int32 */
@@ -176,6 +178,8 @@ export interface BuildExecuteScriptTx {
     gasAmount?: number;
     /** @format uint256 */
     gasPrice?: string;
+    /** @format block-hash */
+    targetBlockHash?: string;
 }
 export interface BuildExecuteScriptTxResult {
     /** @format int32 */
@@ -224,6 +228,8 @@ export interface BuildSweepAddressTransactions {
     gasAmount?: number;
     /** @format uint256 */
     gasPrice?: string;
+    /** @format block-hash */
+    targetBlockHash?: string;
 }
 export interface BuildSweepAddressTransactionsResult {
     unsignedTxs: SweepAddressTransaction[];
@@ -241,6 +247,8 @@ export interface BuildTransaction {
     gasAmount?: number;
     /** @format uint256 */
     gasPrice?: string;
+    /** @format block-hash */
+    targetBlockHash?: string;
 }
 export interface BuildTransactionResult {
     unsignedTx: string;
@@ -303,11 +311,17 @@ export interface CompileContractResult {
     fields: FieldsSig;
     functions: FunctionSig[];
     events: EventSig[];
+    warnings: string[];
+}
+export interface CompileProjectResult {
+    contracts: CompileContractResult[];
+    scripts: CompileScriptResult[];
 }
 export interface CompileScriptResult {
     bytecodeTemplate: string;
     fields: FieldsSig;
     functions: FunctionSig[];
+    warnings: string[];
 }
 export interface Confirmed {
     /** @format block-hash */
@@ -401,7 +415,6 @@ export interface Destination {
 export declare type DiscoveryAction = Reachable | Unreachable;
 export interface EventSig {
     name: string;
-    signature: string;
     fieldNames: string[];
     fieldTypes: string[];
 }
@@ -409,9 +422,9 @@ export interface FetchResponse {
     blocks: BlockEntry[][];
 }
 export interface FieldsSig {
-    signature: string;
     names: string[];
     types: string[];
+    isMutable: boolean[];
 }
 export interface FixedAssetOutput {
     /** @format int32 */
@@ -430,9 +443,12 @@ export interface FixedAssetOutput {
 }
 export interface FunctionSig {
     name: string;
-    signature: string;
-    argNames: string[];
-    argTypes: string[];
+    usePreapprovedAssets: boolean;
+    useAssetsInContract: boolean;
+    isPublic: boolean;
+    paramNames: string[];
+    paramTypes: string[];
+    paramIsMutable: boolean[];
     returnTypes: string[];
 }
 export interface Group {
@@ -514,6 +530,9 @@ export interface Penalty {
     value: number;
     type: string;
 }
+export interface Project {
+    code: string;
+}
 export interface Reachable {
     peers: string[];
     type: string;
@@ -580,6 +599,8 @@ export interface Sweep {
     gasPrice?: string;
     /** @format int32 */
     utxosLimit?: number;
+    /** @format block-hash */
+    targetBlockHash?: string;
 }
 export interface SweepAddressTransaction {
     /** @format 32-byte-hash */
@@ -845,8 +866,8 @@ export declare class HttpClient<SecurityDataType = unknown> {
 }
 /**
  * @title Alephium API
- * @version 1.4.2
- * @baseUrl {protocol}://{host}:{port}
+ * @version 1.5.0
+ * @baseUrl ../
  */
 export declare class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDataType> {
     wallets: {
@@ -1324,6 +1345,15 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @request POST:/contracts/compile-contract
          */
         postContractsCompileContract: (data: Contract, params?: RequestParams) => Promise<CompileContractResult>;
+        /**
+         * No description
+         *
+         * @tags Contracts
+         * @name PostContractsCompileProject
+         * @summary Compile a project
+         * @request POST:/contracts/compile-project
+         */
+        postContractsCompileProject: (data: Project, params?: RequestParams) => Promise<CompileProjectResult>;
         /**
          * No description
          *

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

@@ -28,7 +28,7 @@ var ContentType;
 })(ContentType = exports.ContentType || (exports.ContentType = {}));
 class HttpClient {
     constructor(apiConfig = {}) {
-        this.baseUrl = '{protocol}://{host}:{port}';
+        this.baseUrl = '../';
         this.securityData = null;
         this.abortControllers = new Map();
         this.customFetch = (...fetchParams) => fetch(...fetchParams);
@@ -158,8 +158,8 @@ class HttpClient {
 exports.HttpClient = HttpClient;
 /**
  * @title Alephium API
- * @version 1.4.2
- * @baseUrl {protocol}://{host}:{port}
+ * @version 1.5.0
+ * @baseUrl ../
  */
 class Api extends HttpClient {
     constructor() {
@@ -901,6 +901,22 @@ class Api extends HttpClient {
                 format: 'json',
                 ...params
             }).then(convertHttpResponse),
+            /**
+             * No description
+             *
+             * @tags Contracts
+             * @name PostContractsCompileProject
+             * @summary Compile a project
+             * @request POST:/contracts/compile-project
+             */
+            postContractsCompileProject: (data, params = {}) => this.request({
+                path: `/contracts/compile-project`,
+                method: 'POST',
+                body: data,
+                type: ContentType.Json,
+                format: 'json',
+                ...params
+            }).then(convertHttpResponse),
             /**
              * No description
              *

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

@@ -470,6 +470,22 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @request PUT:/utils/sanity-check
          */
         putUtilsSanityCheck: (params?: RequestParams) => Promise<void>;
+        /**
+         * @description Update global log level, accepted: TRACE, DEBUG, INFO, WARN, ERROR
+         *
+         * @tags Utils
+         * @name PutUtilsUpdateGlobalLoglevel
+         * @request PUT:/utils/update-global-loglevel
+         */
+        putUtilsUpdateGlobalLoglevel: (data: 'TRACE' | 'DEBUG' | 'INFO' | 'WARN' | 'ERROR', params?: RequestParams) => Promise<void>;
+        /**
+         * @description Update logging file, only logback.xml is accepted
+         *
+         * @tags Utils
+         * @name PutUtilsUpdateLogConfig
+         * @request PUT:/utils/update-log-config
+         */
+        putUtilsUpdateLogConfig: (data: string, params?: RequestParams) => Promise<void>;
     };
 }
 export {};

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

@@ -450,6 +450,32 @@ class Api extends HttpClient {
                 path: `/utils/sanity-check`,
                 method: 'PUT',
                 ...params
+            }).then(convertHttpResponse),
+            /**
+             * @description Update global log level, accepted: TRACE, DEBUG, INFO, WARN, ERROR
+             *
+             * @tags Utils
+             * @name PutUtilsUpdateGlobalLoglevel
+             * @request PUT:/utils/update-global-loglevel
+             */
+            putUtilsUpdateGlobalLoglevel: (data, params = {}) => this.request({
+                path: `/utils/update-global-loglevel`,
+                method: 'PUT',
+                body: data,
+                ...params
+            }).then(convertHttpResponse),
+            /**
+             * @description Update logging file, only logback.xml is accepted
+             *
+             * @tags Utils
+             * @name PutUtilsUpdateLogConfig
+             * @request PUT:/utils/update-log-config
+             */
+            putUtilsUpdateLogConfig: (data, params = {}) => this.request({
+                path: `/utils/update-log-config`,
+                method: 'PUT',
+                body: data,
+                ...params
             }).then(convertHttpResponse)
         };
     }

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

@@ -1,79 +1,113 @@
-import { NodeProvider } from '../api';
-import { node } from '../api';
+import { node, NodeProvider } from '../api';
 import { SignDeployContractTxParams, SignExecuteScriptTxParams, SignerWithNodeProvider } from '../signer';
+import { CompileContractResult, CompileScriptResult } from '../api/api-alephium';
+declare type FieldsSig = node.FieldsSig;
+declare type EventSig = node.EventSig;
+declare type FunctionSig = node.FunctionSig;
+declare enum SourceType {
+    Contract = 0,
+    Script = 1,
+    AbstractContract = 2,
+    Interface = 3
+}
+export declare type CompilerOptions = {
+    errorOnWarnings: boolean;
+    ignoreUnusedConstantsWarnings: boolean;
+};
+export declare const DEFAULT_COMPILER_OPTIONS: CompilerOptions;
+declare class TypedMatcher<T extends SourceType> {
+    matcher: RegExp;
+    type: T;
+    name: string | undefined;
+    constructor(pattern: string, type: T);
+    match(str: string): number;
+}
 declare class SourceFile {
-    readonly dirs: string[];
-    readonly dirPath: string;
-    readonly contractPath: string;
-    readonly artifactPath: string;
-    constructor(dirs: string[], fileName: string);
-}
-export declare abstract class Common {
-    readonly sourceCodeSha256: string;
-    readonly functions: node.FunctionSig[];
-    static readonly importRegex: RegExp;
-    static readonly contractRegex: RegExp;
-    static readonly interfaceRegex: RegExp;
-    static readonly scriptRegex: RegExp;
-    private static _artifactCache;
-    static artifactCacheCapacity: number;
-    protected static _getArtifactFromCache(codeHash: string): Contract | Script | undefined;
-    protected static _putArtifactToCache(contract: Contract): void;
-    constructor(sourceCodeSha256: string, functions: node.FunctionSig[]);
-    protected static _artifactsFolder(): string;
-    static getSourceFile(path: string, _dirs: string[]): SourceFile;
-    protected static _handleImports(pathes: string[], contractStr: string, importsCache: string[]): Promise<string>;
-    protected static _loadContractStr(sourceFile: SourceFile, importsCache: string[], validate: (code: string) => void): Promise<string>;
-    static checkFileNameExtension(fileName: string): void;
-    protected static _from<T extends {
-        sourceCodeSha256: string;
-    }>(provider: NodeProvider, sourceFile: SourceFile, loadContractStr: (sourceFile: SourceFile, importsCache: string[]) => Promise<string>, compile: (provider: NodeProvider, sourceFile: SourceFile, contractStr: string, contractHash: string) => Promise<T>): Promise<T>;
-    protected _saveToFile(sourceFile: SourceFile): Promise<void>;
+    type: SourceType;
+    typeId: string;
+    contractPath: string;
+    sourceCode: string;
+    sourceCodeHash: string;
+    getArtifactPath(artifactsRootPath: string): string;
+    constructor(type: SourceType, typeId: string, sourceCode: string, contractPath: string);
+}
+declare class Compiled<T extends Artifact> {
+    sourceFile: SourceFile;
+    artifact: T;
+    warnings: string[];
+    constructor(sourceFile: SourceFile, artifact: T, warnings: string[]);
+}
+export declare class Project {
+    sourceFiles: SourceFile[];
+    contracts: Compiled<Contract>[];
+    scripts: Compiled<Script>[];
+    readonly contractsRootPath: string;
+    readonly artifactsRootPath: string;
+    readonly nodeProvider: NodeProvider;
+    static currentProject: Project;
+    static readonly abstractContractMatcher: TypedMatcher<SourceType>;
+    static readonly contractMatcher: TypedMatcher<SourceType.Contract>;
+    static readonly interfaceMatcher: TypedMatcher<SourceType.Interface>;
+    static readonly scriptMatcher: TypedMatcher<SourceType.Script>;
+    static readonly matchers: TypedMatcher<SourceType>[];
+    private constructor();
+    private getContractPath;
+    private static checkCompilerWarnings;
+    static contract(path: string, compilerOptions?: Partial<CompilerOptions>): Contract;
+    static script(path: string, compilerOptions?: Partial<CompilerOptions>): Script;
+    private saveArtifactsToFile;
+    contractByCodeHash(codeHash: string): Contract;
+    private saveProjectArtifactToFile;
+    private static compile;
+    private static loadArtifacts;
+    private static loadSourceFile;
+    private static loadSourceFiles;
+    static build(contractsRootPath?: string, artifactsRootPath?: string): Promise<void>;
+}
+export declare abstract class Artifact {
+    readonly typeId: string;
+    readonly functions: FunctionSig[];
+    constructor(typeId: string, functions: FunctionSig[]);
     abstract buildByteCodeToDeploy(initialFields?: Fields): string;
+    publicFunctions(): string[];
+    usingPreapprovedAssetsFunctions(): string[];
+    usingAssetsInContractFunctions(): string[];
 }
-export declare class Contract extends Common {
+export declare class Contract extends Artifact {
     readonly bytecode: string;
     readonly codeHash: string;
-    readonly fieldsSig: node.FieldsSig;
-    readonly eventsSig: node.EventSig[];
-    constructor(sourceCodeSha256: string, bytecode: string, codeHash: string, fieldsSig: node.FieldsSig, eventsSig: node.EventSig[], functions: node.FunctionSig[]);
-    static checkCodeType(fileName: string, contractStr: string): void;
-    private static loadContractStr;
-    static fromSource(provider: NodeProvider, path: string): Promise<Contract>;
-    private static compile;
+    readonly fieldsSig: FieldsSig;
+    readonly eventsSig: EventSig[];
+    constructor(typeId: string, bytecode: string, codeHash: string, fieldsSig: FieldsSig, eventsSig: EventSig[], functions: FunctionSig[]);
     static fromJson(artifact: any): Contract;
+    static fromCompileResult(typeId: string, result: CompileContractResult): Contract;
     static fromArtifactFile(path: string): Promise<Contract>;
-    fetchState(provider: NodeProvider, address: string, group: number): Promise<ContractState>;
+    fetchState(address: string, group: number): Promise<ContractState>;
     toString(): string;
     toState(fields: Fields, asset: Asset, address?: string): ContractState;
     static randomAddress(): string;
     private _test;
-    testPublicMethod(provider: NodeProvider, funcName: string, params: TestContractParams): Promise<TestContractResult>;
-    testPrivateMethod(provider: NodeProvider, funcName: string, params: TestContractParams): Promise<TestContractResult>;
+    testPublicMethod(funcName: string, params: TestContractParams): Promise<TestContractResult>;
+    testPrivateMethod(funcName: string, params: TestContractParams): Promise<TestContractResult>;
     toApiFields(fields?: Fields): node.Val[];
     toApiArgs(funcName: string, args?: Arguments): node.Val[];
     getMethodIndex(funcName: string): number;
     toApiContractStates(states?: ContractState[]): node.ContractState[] | undefined;
     toTestContract(funcName: string, params: TestContractParams): node.TestContract;
-    static fromCodeHash(codeHash: string): Promise<Contract>;
-    static getFieldsSig(state: node.ContractState): Promise<node.FieldsSig>;
     fromApiContractState(state: node.ContractState): Promise<ContractState>;
-    static ContractCreatedEvent: node.EventSig;
-    static ContractDestroyedEvent: node.EventSig;
+    static ContractCreatedEvent: EventSig;
+    static ContractDestroyedEvent: EventSig;
     static fromApiEvent(event: node.ContractEventByTxId, codeHash: string | undefined): Promise<ContractEventByTxId>;
     fromTestContractResult(methodIndex: number, result: node.TestContractResult): Promise<TestContractResult>;
     paramsForDeployment(params: BuildDeployContractTx): Promise<SignDeployContractTxParams>;
     transactionForDeployment(signer: SignerWithNodeProvider, params: Omit<BuildDeployContractTx, 'signerAddress'>): Promise<DeployContractTransaction>;
     buildByteCodeToDeploy(initialFields: Fields): string;
 }
-export declare class Script extends Common {
+export declare class Script extends Artifact {
     readonly bytecodeTemplate: string;
-    readonly fieldsSig: node.FieldsSig;
-    constructor(sourceCodeSha256: string, bytecodeTemplate: string, fieldsSig: node.FieldsSig, functions: node.FunctionSig[]);
-    static checkCodeType(fileName: string, contractStr: string): void;
-    private static loadContractStr;
-    static fromSource(provider: NodeProvider, path: string): Promise<Script>;
-    private static compile;
+    readonly fieldsSig: FieldsSig;
+    constructor(typeId: string, bytecodeTemplate: string, fieldsSig: FieldsSig, functions: FunctionSig[]);
+    static fromCompileResult(typeId: string, result: CompileScriptResult): Script;
     static fromJson(artifact: any): Script;
     static fromArtifactFile(path: string): Promise<Script>;
     toString(): string;
@@ -107,7 +141,7 @@ export interface ContractState {
     initialStateHash?: string;
     codeHash: string;
     fields: Fields;
-    fieldsSig: node.FieldsSig;
+    fieldsSig: FieldsSig;
     asset: Asset;
 }
 export interface TestContractParams {