# org.swappulse.tradeChain

> Published by [bridge.swappulse.org](https://lexicon.garden/identity/did:plc:jwoatauidzr4lollmro2gh35)

## Description

A multi-party trade chain (3-5 participants shipping cards in sequence), mirrored to AT Protocol as a real org.swappulse.tradeChain record so chains are portable and verifiable across instances.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:jwoatauidzr4lollmro2gh35/org.swappulse.tradeChain)
- [Documentation](https://lexicon.garden/lexicon/did:plc:jwoatauidzr4lollmro2gh35/org.swappulse.tradeChain/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:jwoatauidzr4lollmro2gh35/org.swappulse.tradeChain/examples)

## Definitions

### `org.swappulse.tradeChain`

**Type**: `record`

A multi-party trade chain.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `status` | `string` | Yes |  |
| `createdAt` | `string` (datetime) | Yes |  |
| `chainOrder` | `string` | Yes |  |
| `totalValue` | `number` | Yes |  |
| `completedAt` | `string` (datetime) | No |  |
| `shipstoDids` | `array` | No |  |
| `organiserDid` | `string` (did) | No |  |
| `organiserName` | `string` | No |  |
| `participantDids` | `array` | Yes |  |
| `participantNames` | `array` | No |  |
| `receiptConfirmed` | `array` | No |  |
| `tradeListingUris` | `array` | No |  |
| `shippingConfirmed` | `array` | No |  |

## Raw Schema

```json
{
  "id": "org.swappulse.tradeChain",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "participantDids",
          "chainOrder",
          "status",
          "totalValue",
          "createdAt"
        ],
        "properties": {
          "status": {
            "type": "string",
            "knownValues": [
              "proposed",
              "accepted",
              "in_transit",
              "completed",
              "cancelled"
            ]
          },
          "createdAt": {
            "type": "string",
            "format": "datetime"
          },
          "chainOrder": {
            "type": "string",
            "knownValues": [
              "clockwise",
              "anticlockwise"
            ]
          },
          "totalValue": {
            "type": "number"
          },
          "completedAt": {
            "type": "string",
            "format": "datetime"
          },
          "shipstoDids": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "did"
            }
          },
          "organiserDid": {
            "type": "string",
            "format": "did"
          },
          "organiserName": {
            "type": "string"
          },
          "participantDids": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "did"
            }
          },
          "participantNames": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "receiptConfirmed": {
            "type": "array",
            "items": {
              "type": "boolean"
            }
          },
          "tradeListingUris": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "at-uri"
            }
          },
          "shippingConfirmed": {
            "type": "array",
            "items": {
              "type": "boolean"
            }
          }
        }
      },
      "description": "A multi-party trade chain."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1,
  "revision": 1,
  "description": "A multi-party trade chain (3-5 participants shipping cards in sequence), mirrored to AT Protocol as a real org.swappulse.tradeChain record so chains are portable and verifiable across instances."
}
```