feat(core): add Vault module with availability-for-exchange endpoint and contract state reading

miguelnietoa · miguelnietoa · commit dedabe8c013e · 2026-03-11T17:24:28.000-05:00
diff --git a/apps/core/src/app.module.ts b/apps/core/src/app.module.ts
@@ -7,9 +7,18 @@ import { CampaignsModule } from './campaigns/campaigns.module';
 import { InvestmentsModule } from './investments/investments.module';
 import { DeployModule } from './deploy/deploy.module';
 import { LoansModule } from './loans/loans.module';
+import { VaultModule } from './vault/vault.module';
 
 @Module({
-  imports: [PrismaModule, SorobanModule, CampaignsModule, InvestmentsModule, DeployModule, LoansModule],
+  imports: [
+    PrismaModule,
+    SorobanModule,
+    CampaignsModule,
+    InvestmentsModule,
+    DeployModule,
+    LoansModule,
+    VaultModule,
+  ],
   controllers: [AppController],
   providers: [AppService],
 })
diff --git a/apps/core/src/campaigns/campaigns.controller.ts b/apps/core/src/campaigns/campaigns.controller.ts
@@ -32,10 +32,7 @@ export class CampaignsController {
   }
 
   @Patch(':id/status')
-  updateStatus(
-    @Param('id') id: string,
-    @Body() dto: UpdateCampaignStatusDto,
-  ) {
+  updateStatus(@Param('id') id: string, @Body() dto: UpdateCampaignStatusDto) {
     return this.campaignsService.updateStatus(id, dto);
   }
 
diff --git a/apps/core/src/campaigns/campaigns.module.ts b/apps/core/src/campaigns/campaigns.module.ts
@@ -6,4 +6,4 @@ import { CampaignsService } from './campaigns.service';
   controllers: [CampaignsController],
   providers: [CampaignsService],
 })
-export class CampaignsModule {}
+export class CampaignsModule {}
diff --git a/apps/core/src/campaigns/campaigns.service.ts b/apps/core/src/campaigns/campaigns.service.ts
@@ -13,10 +13,7 @@ const ALLOWED_TRANSITIONS: Record<CampaignStatus, CampaignStatus[]> = {
   [CampaignStatus.DRAFT]: [CampaignStatus.FUNDRAISING, CampaignStatus.PAUSED],
   [CampaignStatus.FUNDRAISING]: [CampaignStatus.ACTIVE, CampaignStatus.PAUSED],
   [CampaignStatus.ACTIVE]: [CampaignStatus.REPAYMENT, CampaignStatus.PAUSED],
-  [CampaignStatus.REPAYMENT]: [
-    CampaignStatus.CLAIMABLE,
-    CampaignStatus.PAUSED,
-  ],
+  [CampaignStatus.REPAYMENT]: [CampaignStatus.CLAIMABLE, CampaignStatus.PAUSED],
   [CampaignStatus.CLAIMABLE]: [CampaignStatus.CLOSED, CampaignStatus.PAUSED],
   [CampaignStatus.CLOSED]: [],
   [CampaignStatus.PAUSED]: [],
@@ -74,7 +71,10 @@ export class CampaignsService {
     );
     this.validatePrerequisites(campaign, newStatus);
 
-    const data: { status: CampaignStatus; previousStatus?: CampaignStatus | null } = {
+    const data: {
+      status: CampaignStatus;
+      previousStatus?: CampaignStatus | null;
+    } = {
       status: newStatus,
     };
 
@@ -96,9 +96,7 @@ export class CampaignsService {
     previousStatus: CampaignStatus | null,
   ) {
     if (current === next) {
-      throw new BadRequestException(
-        `Campaign is already in status ${current}`,
-      );
+      throw new BadRequestException(`Campaign is already in status ${current}`);
     }
 
     if (current === CampaignStatus.PAUSED) {
diff --git a/apps/core/src/campaigns/dto/update-campaign.dto.ts b/apps/core/src/campaigns/dto/update-campaign.dto.ts
@@ -46,4 +46,4 @@ export class UpdateCampaignDto {
   @IsString()
   @IsOptional()
   tokenFactoryId?: string;
-}
+}
diff --git a/apps/core/src/deploy/deploy.controller.ts b/apps/core/src/deploy/deploy.controller.ts
@@ -25,4 +25,4 @@ export class DeployController {
     const unsignedXdr = await this.deployService.deployVault(dto);
     return { unsignedXdr };
   }
-}
+}
diff --git a/apps/core/src/deploy/deploy.service.ts b/apps/core/src/deploy/deploy.service.ts
@@ -58,4 +58,4 @@ export class DeployService {
       dto.callerPublicKey,
     );
   }
-}
+}
diff --git a/apps/core/src/deploy/dto/deploy-participation-token.dto.ts b/apps/core/src/deploy/dto/deploy-participation-token.dto.ts
@@ -8,4 +8,4 @@ export class DeployParticipationTokenDto {
   @IsString()
   @IsNotEmpty()
   callerPublicKey: string;
-}
+}
diff --git a/apps/core/src/investments/dto/create-investment.dto.ts b/apps/core/src/investments/dto/create-investment.dto.ts
@@ -20,4 +20,4 @@ export class CreateInvestmentDto {
   @IsString()
   @IsNotEmpty()
   txHash: string;
-}
+}
diff --git a/apps/core/src/investments/investments.controller.ts b/apps/core/src/investments/investments.controller.ts
@@ -25,4 +25,4 @@ export class InvestmentsController {
   create(@Body() dto: CreateInvestmentDto) {
     return this.investmentsService.create(dto);
   }
-}
+}
diff --git a/apps/core/src/investments/investments.module.ts b/apps/core/src/investments/investments.module.ts
@@ -6,4 +6,4 @@ import { InvestmentsService } from './investments.service';
   controllers: [InvestmentsController],
   providers: [InvestmentsService],
 })
-export class InvestmentsModule {}
+export class InvestmentsModule {}
diff --git a/apps/core/src/investments/investments.service.ts b/apps/core/src/investments/investments.service.ts
@@ -37,4 +37,4 @@ export class InvestmentsService {
       include: { campaign: true },
     });
   }
-}
+}
diff --git a/apps/core/src/loans/loans.service.spec.ts b/apps/core/src/loans/loans.service.spec.ts
@@ -75,10 +75,7 @@ describe('LoansService', () => {
     };
 
     const module: TestingModule = await Test.createTestingModule({
-      providers: [
-        LoansService,
-        { provide: PrismaService, useValue: prisma },
-      ],
+      providers: [LoansService, { provide: PrismaService, useValue: prisma }],
     }).compile();
 
     service = module.get<LoansService>(LoansService);
diff --git a/apps/core/src/prisma/prisma.module.ts b/apps/core/src/prisma/prisma.module.ts
@@ -6,4 +6,4 @@ import { PrismaService } from './prisma.service';
   providers: [PrismaService],
   exports: [PrismaService],
 })
-export class PrismaModule {}
+export class PrismaModule {}
diff --git a/apps/core/src/soroban/soroban.module.ts b/apps/core/src/soroban/soroban.module.ts
@@ -6,4 +6,4 @@ import { SorobanService } from './soroban.service';
   providers: [SorobanService],
   exports: [SorobanService],
 })
-export class SorobanModule {}
+export class SorobanModule {}
diff --git a/apps/core/src/soroban/soroban.service.ts b/apps/core/src/soroban/soroban.service.ts
@@ -40,8 +40,26 @@ export class SorobanService {
       publicKey: callerPublicKey,
     });
 
-    const tx = await (client)[method](args);
+    const tx = await client[method](args);
 
     return tx.toXDR();
   }
-}
+
+  async readContractState(
+    contractId: string,
+    method: string,
+    args: Record<string, unknown>,
+    callerPublicKey: string,
+  ): Promise<unknown> {
+    const client = await contract.Client.from({
+      contractId,
+      rpcUrl: this.rpcUrl,
+      networkPassphrase: this.networkPassphrase,
+      publicKey: callerPublicKey,
+    });
+
+    const result = await client[method](args);
+
+    return result.result;
+  }
+}
diff --git a/apps/core/src/vault/dto/availability-for-exchange.dto.ts b/apps/core/src/vault/dto/availability-for-exchange.dto.ts
@@ -0,0 +1,19 @@
+import { IsString, IsBoolean, IsNotEmpty } from 'class-validator';
+
+export class AvailabilityForExchangeDto {
+  @IsString()
+  @IsNotEmpty()
+  contractId: string;
+
+  @IsString()
+  @IsNotEmpty()
+  admin: string;
+
+  @IsBoolean()
+  @IsNotEmpty()
+  enabled: boolean;
+
+  @IsString()
+  @IsNotEmpty()
+  callerPublicKey: string;
+}
diff --git a/apps/core/src/vault/vault.controller.ts b/apps/core/src/vault/vault.controller.ts
@@ -0,0 +1,14 @@
+import { Controller, Post, Body } from '@nestjs/common';
+import { VaultService } from './vault.service';
+import { AvailabilityForExchangeDto } from './dto/availability-for-exchange.dto';
+
+@Controller('vault')
+export class VaultController {
+  constructor(private readonly vaultService: VaultService) {}
+
+  @Post('availability-for-exchange')
+  async availabilityForExchange(@Body() dto: AvailabilityForExchangeDto) {
+    const unsignedXdr = await this.vaultService.availabilityForExchange(dto);
+    return { unsignedXdr };
+  }
+}
diff --git a/apps/core/src/vault/vault.module.ts b/apps/core/src/vault/vault.module.ts
@@ -0,0 +1,9 @@
+import { Module } from '@nestjs/common';
+import { VaultController } from './vault.controller';
+import { VaultService } from './vault.service';
+
+@Module({
+  controllers: [VaultController],
+  providers: [VaultService],
+})
+export class VaultModule {}
diff --git a/apps/core/src/vault/vault.service.ts b/apps/core/src/vault/vault.service.ts
@@ -0,0 +1,20 @@
+import { Injectable } from '@nestjs/common';
+import { SorobanService } from '../soroban/soroban.service';
+import { AvailabilityForExchangeDto } from './dto/availability-for-exchange.dto';
+
+@Injectable()
+export class VaultService {
+  constructor(private readonly soroban: SorobanService) {}
+
+  availabilityForExchange(dto: AvailabilityForExchangeDto): Promise<string> {
+    return this.soroban.buildContractCallTransaction(
+      dto.contractId,
+      'availability_for_exchange',
+      {
+        admin: dto.admin,
+        enabled: dto.enabled,
+      },
+      dto.callerPublicKey,
+    );
+  }
+}

Original file line number	Diff line number	Diff line change
`@@ -32,10 +32,7 @@ export class CampaignsController {`
`32`	`32`	`}`
`33`	`33`
`34`	`34`	`@Patch(':id/status')`
`35`		`- updateStatus(`
`36`		`- @Param('id') id: string,`
`37`		`- @Body() dto: UpdateCampaignStatusDto,`
`38`		`- ) {`
	`35`	`+ updateStatus(@Param('id') id: string, @Body() dto: UpdateCampaignStatusDto) {`
`39`	`36`	`return this.campaignsService.updateStatus(id, dto);`
`40`	`37`	`}`
`41`	`38`
Original file line number	Diff line number	Diff line change
`@@ -25,4 +25,4 @@ export class DeployController {`
`25`	`25`	`const unsignedXdr = await this.deployService.deployVault(dto);`
`26`	`26`	`return { unsignedXdr };`
`27`	`27`	`}`
`28`		`-}`
	`28`	`+}`
Original file line number	Diff line number	Diff line change
`@@ -58,4 +58,4 @@ export class DeployService {`
`58`	`58`	`dto.callerPublicKey,`
`59`	`59`	`);`
`60`	`60`	`}`
`61`		`-}`
	`61`	`+}`
Original file line number	Diff line number	Diff line change
`@@ -25,4 +25,4 @@ export class InvestmentsController {`
`25`	`25`	`create(@Body() dto: CreateInvestmentDto) {`
`26`	`26`	`return this.investmentsService.create(dto);`
`27`	`27`	`}`
`28`		`-}`
	`28`	`+}`