fix(contract): add missed sourceCodePath cases

src/contract/Contract.ts

@@ -132,11 +132,19 @@ class Contract<M extends ContractMethodsBase> {
    */
   async $compile(): Promise<Encoded.ContractBytearray> {
     if (this.$options.bytecode != null) return this.$options.bytecode;
-    if (this.$options.sourceCode == null) throw new IllegalArgumentError('Can\'t compile without source code');
     if (this.$options.onCompiler == null) throw new IllegalArgumentError('Can\'t compile without compiler');
-    this.$options.bytecode = (await this.$options.onCompiler
-      .compileBySourceCode(this.$options.sourceCode, this.$options.fileSystem)
-    ).bytecode;
+    if (this.$options.sourceCode != null) {
+      const { bytecode } = await this.$options.onCompiler
+        .compileBySourceCode(this.$options.sourceCode, this.$options.fileSystem);
+      this.$options.bytecode = bytecode;
+    }
+    if (this.$options.sourceCodePath != null) {
+      const { bytecode } = await this.$options.onCompiler.compile(this.$options.sourceCodePath);
+      this.$options.bytecode = bytecode;
+    }
+    if (this.$options.bytecode == null) {
+      throw new IllegalArgumentError('Can\'t compile without sourceCode and sourceCodePath');
+    }
     return this.$options.bytecode;
   }
 
@@ -478,7 +486,7 @@ class Contract<M extends ContractMethodsBase> {
       ) as Encoded.ContractAddress;
     }
 
-    if (address == null && sourceCode == null && bytecode == null) {
+    if (address == null && sourceCode == null && sourceCodePath == null && bytecode == null) {
       throw new MissingContractAddressError('Can\'t create instance by ACI without address');
     }
 
@@ -495,12 +503,25 @@ class Contract<M extends ContractMethodsBase> {
       else if (sourceCode != null) {
         if (onCompiler == null) throw new IllegalArgumentError('Can\'t validate bytecode without compiler');
         isValid = await onCompiler.validateBySourceCode(onChanBytecode, sourceCode, fileSystem);
+      } else if (sourceCodePath != null) {
+        if (onCompiler == null) throw new IllegalArgumentError('Can\'t validate bytecode without compiler');
+        isValid = await onCompiler.validate(onChanBytecode, sourceCodePath);
+      }
+      if (!isValid) {
+        throw new BytecodeMismatchError((sourceCode ?? sourceCodePath) != null ? 'source code' : 'bytecode');
       }
-      if (!isValid) throw new BytecodeMismatchError(sourceCode != null ? 'source code' : 'bytecode');
     }
 
     return new ContractWithMethods<M>({
-      onCompiler, onNode, sourceCode, bytecode, aci, address, fileSystem, ...otherOptions,
+      onCompiler,
+      onNode,
+      sourceCode,
+      sourceCodePath,
+      bytecode,
+      aci,
+      address,
+      fileSystem,
+      ...otherOptions,
     });
   }
 

src/contract/compiler/Base.ts

@@ -13,6 +13,9 @@ export type Aci = Array<{
     name: string;
     event?: any;
     functions: FunctionAci[];
+    kind: string; // known values: 'contract_main'
+    payable: boolean;
+    typedefs: any[];
   };
 }>;
 

src/utils/errors.ts

@@ -488,7 +488,7 @@ export class MissingContractAddressError extends ContractError {
  */
 export class MissingContractDefError extends ContractError {
   constructor() {
-    super('Either ACI or source code is required');
+    super('Either ACI or sourceCode or sourceCodePath is required');
     this.name = 'MissingContractDefError';
   }
 }

test/integration/contract-aci.ts

@@ -203,6 +203,30 @@ describe('Contract instance', () => {
     expect(testContract.$options.bytecode).to.satisfy((b: string) => b.startsWith('cb_'));
   });
 
+  it('compiles contract by sourceCodePath', async () => {
+    const ctr = await aeSdk.initializeContract({
+      aci: [{
+        contract: {
+          functions: [{
+            arguments: [{ name: 'x', type: 'int' }],
+            name: 'increment',
+            payable: false,
+            returns: 'int',
+            stateful: false,
+          },
+          ],
+          kind: 'contract_main',
+          name: 'Increment',
+          payable: false,
+          typedefs: [],
+        },
+      }],
+      sourceCodePath: './test/integration/contracts/Increment.aes',
+    });
+    expect(ctr.$options.bytecode).to.equal(undefined);
+    expect(await ctr.$compile()).to.satisfy((b: string) => b.startsWith('cb_'));
+  });
+
   it('fails on calling without deployment', () => expect(testContract.intFn(2))
     .to.be.rejectedWith(MissingContractAddressError, 'Can\'t dry-run contract without address'));
 
@@ -275,7 +299,8 @@ describe('Contract instance', () => {
 
   it('generates by bytecode and aci', async () => aeSdk.initializeContract({ bytecode: testContractBytecode, aci: testContractAci }));
 
-  it('fails on generation without arguments', () => expect(aeSdk.initializeContract()).to.be.rejectedWith(MissingContractDefError, 'Either ACI or source code is required'));
+  it('fails on generation without arguments', () => expect(aeSdk.initializeContract())
+    .to.be.rejectedWith(MissingContractDefError, 'Either ACI or sourceCode or sourceCodePath is required'));
 
   it('calls by aci', async () => {
     const contract = await aeSdk.initializeContract<TestContractApi>(