Vault Formation

Create Vault

Creates a new vault with specified configuration.

POST /api/v1/vaults

Sample Request

{
  "vaultType": "PRIVATE",
  "assetTypes": ["SINGLE_NFT"],
  "settings": {
    "assetWhitelist": ["addr1...", "addr2..."],
    "contributorWhitelist": ["addr3...", "addr4..."],
    "assetWindow": {
      "startTime": "2024-12-01T00:00:00Z",
      "duration": "02:00:00"
    },
    "investorWhitelist": ["addr5...", "addr6..."],
    "valuationType": "FIXED",
    "fractionalization": {
      "percentage": "75.00",
      "tokenSupply": "1000000",
      "tokenDecimals": "6",
      "tokenImage": "ipfs://Qm..."
    },
    "investment": {
      "window": "48:00:00",
      "reserve": "20.00",
      "liquidityPool": "5.00"
    },
    "termination": {
      "type": "DAO",
      "fdp": "10.00"
    }
  }
}

Sample Response

{
  "status": "success",
  "data": {
    "vaultId": "v_abc123",
    "contractAddress": "addr_vault123...",
    "status": "CREATED",
    "timestamps": {
      "created": "2024-11-20T10:00:00Z",
      "assetWindowStart": "2024-12-01T00:00:00Z",
      "assetWindowEnd": "2024-12-01T02:00:00Z"
    },
    "transactionHash": "tx_hash123..."
  }
}

Add Assets to Vault

Add assets during the asset window period.

POST /api/v1/vaults/{vaultId}/assets

Sample Request

{
  "assets": [{
    "contractAddress": "addr_nft123...",
    "tokenId": "42",
    "quantity": "1"
  }]
}

Sample Response

{
  "status": "success",
  "data": {
    "addedAssets": [{
      "assetId": "asset_123",
      "status": "LOCKED",
      "transactionHash": "tx_hash456..."
    }],
    "vaultValuation": {
      "totalValue": "100000",
      "floorPrice": "90000",
      "dexPrice": "10000",
      "timestamp": "2024-12-01T01:00:00Z"
    }
  }
}