Method proposeSwap

modules/swap/SwapModule.ts:1004–1206

(deal: SwapDeal, options?: ProposeSwapOptions)

  }

  async proposeSwap(deal: SwapDeal, options?: ProposeSwapOptions): Promise<SwapProposalResult> {
    this.ensureNotDestroyed();
    this.ensureReady();
    const deps = this.deps!;

    // Step 2: Validate deal fields (§17.1)
    if (typeof deal.partyA !== 'string' || deal.partyA.length === 0) {
      throw new SphereError('SWAP_INVALID_DEAL: partyA is required', 'SWAP_INVALID_DEAL');
    }
    if (typeof deal.partyB !== 'string' || deal.partyB.length === 0) {
      throw new SphereError('SWAP_INVALID_DEAL: partyB is required', 'SWAP_INVALID_DEAL');
    }
    if (deal.partyA.toLowerCase() === deal.partyB.toLowerCase()) {
      throw new SphereError('SWAP_INVALID_DEAL: partyA and partyB must be different', 'SWAP_INVALID_DEAL');
    }
    const currencyRe = /^[A-Za-z0-9]{1,20}$/;
    if (typeof deal.partyACurrency !== 'string' || !currencyRe.test(deal.partyACurrency)) {
      throw new SphereError('SWAP_INVALID_DEAL: partyACurrency must be 1-20 alphanumeric characters', 'SWAP_INVALID_DEAL');
    }
    if (typeof deal.partyBCurrency !== 'string' || !currencyRe.test(deal.partyBCurrency)) {
      throw new SphereError('SWAP_INVALID_DEAL: partyBCurrency must be 1-20 alphanumeric characters', 'SWAP_INVALID_DEAL');
    }
    if (deal.partyACurrency === deal.partyBCurrency) {
      throw new SphereError('SWAP_INVALID_DEAL: currencies must differ', 'SWAP_INVALID_DEAL');
    }
    const amountRe = /^[1-9][0-9]*$/;
    if (typeof deal.partyAAmount !== 'string' || !amountRe.test(deal.partyAAmount)) {
      throw new SphereError('SWAP_INVALID_DEAL: partyAAmount must be a positive integer string', 'SWAP_INVALID_DEAL');
    }
    if (typeof deal.partyBAmount !== 'string' || !amountRe.test(deal.partyBAmount)) {
      throw new SphereError('SWAP_INVALID_DEAL: partyBAmount must be a positive integer string', 'SWAP_INVALID_DEAL');
    }
    if (typeof deal.timeout !== 'number' || !Number.isInteger(deal.timeout) || deal.timeout < 60 || deal.timeout > 86400) {
      throw new SphereError('SWAP_INVALID_DEAL: timeout must be an integer between 60 and 86400 seconds', 'SWAP_INVALID_DEAL');
    }

    // Step 3: Resolve escrow address
    const escrowAddress = deal.escrowAddress ?? this.config.defaultEscrowAddress;
    if (!escrowAddress) {
      throw new SphereError(
        'No escrow address: provide deal.escrowAddress or configure defaultEscrowAddress',
        'SWAP_INVALID_DEAL',
      );
    }
    const escrowPeer = await deps.resolve(escrowAddress);
    if (!escrowPeer) {
      throw new SphereError(`Cannot resolve escrow address: ${escrowAddress}`, 'SWAP_RESOLVE_FAILED');
    }

    // Step 4: Resolve party addresses
    const peerA = await deps.resolve(deal.partyA);
    if (!peerA) {
      throw new SphereError(`Cannot resolve party A address: ${deal.partyA}`, 'SWAP_RESOLVE_FAILED');
    }
    const peerB = await deps.resolve(deal.partyB);
    if (!peerB) {
      throw new SphereError(`Cannot resolve party B address: ${deal.partyB}`, 'SWAP_RESOLVE_FAILED');
    }