LifecycleReadService
Get Flow By Id
Retrieve one lifecycle flow by public flow id.
Request
curl --request GET \ \ --url 'https://api.testnet.polyester.com/v1/chain/flows/flow_7YWHMfk9JZeLMgZauHuiSxhI' \ --header 'Accept: */*'
Responses
{
"flow": {
"fromLiveState": false,
"observedSteps": [
{
"activities": [
{
"amountE18": {
"hi": "1",
"lo": "1"
},
"approveCount": 1,
"currentConfirmations": 1,
"kind": "MINTED",
"ledgerTransferId": "9155001234568",
"lifecycleReason": "ZIPPER_VALIDATION_REJECTED",
"lifecycleSource": "RELAYER",
"occurredAtUnixMs": "1",
"rejectCount": 1,
"requiredApprovals": 1,
"requiredConfirmations": 1,
"requiredRejections": 1,
"sequence": 1,
"txRef": "0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890",
"validatorCount": 1,
"zipperReason": {
"code": "DEPOSIT_WAIT_EXPIRED",
"message": "value",
"reasonId": "value"
}
}
],
"amountE18": {
"hi": "1",
"lo": "1"
},
"approveCount": 1,
"assetIds": {
"unifiedAssetId": 100,
"zippedAssetId": 100
},
"blockTimeMovingAverageMs": "1",
"currentConfirmations": 1,
"lifecycleReason": "ZIPPER_VALIDATION_REJECTED",
"lifecycleSource": "RELAYER",
"milestoneTxRef": "0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890",
"occurredAtUnixMs": "1",
"polyesterChainId": 1,
"rejectCount": 1,
"requestFee": {
"amountE18": {
"hi": "1",
"lo": "1"
},
"assetIds": {
"unifiedAssetId": 100,
"zippedAssetId": 100
},
"recipientAddress": "0x3333333333333333333333333333333333333333",
"status": "LOCKED"
},
"requiredApprovals": 1,
"requiredConfirmations": 1,
"requiredRejections": 1,
"sequence": 1,
"step": "SOURCE",
"validatorCount": 1,
"zipperReason": {
"code": "DEPOSIT_WAIT_EXPIRED",
"message": "value",
"reasonId": "value"
}
}
],
"summary": {
"amountE18": {
"hi": "1",
"lo": "1"
},
"assetIds": {
"unifiedAssetId": 100,
"zippedAssetId": 100
},
"currentProgress": {
"approveCount": 1,
"currentConfirmations": 1,
"currentStepExpectedDurationMs": "1",
"currentStepStartedAtUnixMs": "1",
"rejectCount": 1,
"requiredApprovals": 1,
"requiredConfirmations": 1,
"requiredRejections": 1,
"validatorCount": 1
},
"currentStep": "SOURCE",
"currentStepSequence": 1,
"destinationAddress": "0x3333333333333333333333333333333333333333",
"destinationDomain": "EXTERNAL_CHAIN",
"estimatedCompletionUnixMs": "1",
"flowId": "flow_7YWHMfk9JZeLMgZauHuiSxhI",
"flowKind": "DEPOSIT",
"isOpen": false,
"isTerminal": false,
"lastActivityAtUnixMs": "1",
"latestLifecycleSource": "RELAYER",
"latestTxRef": "0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890",
"lifecycleReason": "ZIPPER_VALIDATION_REJECTED",
"ownerAccountId": "7563897446546",
"polyesterChainId": 1,
"progressTimeline": [
{
"expectedDurationMs": "1",
"sequence": 1,
"status": "COMPLETED",
"step": "SOURCE"
}
],
"requestFee": {
"amountE18": {
"hi": "1",
"lo": "1"
},
"assetIds": {
"unifiedAssetId": 100,
"zippedAssetId": 100
},
"recipientAddress": "0x3333333333333333333333333333333333333333",
"status": "LOCKED"
},
"smartAccountAddress": "0x2222222222222222222222222222222222222222",
"sourceAddress": "0x4444444444444444444444444444444444444444",
"sourceDomain": "EXTERNAL_CHAIN",
"sourceTxHash": "0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890",
"startedAtUnixMs": "1",
"terminalAtUnixMs": "1",
"txOccurrenceIndex": "1",
"updatedAtUnixMs": "1",
"zipperReason": {
"code": "DEPOSIT_WAIT_EXPIRED",
"message": "value",
"reasonId": "value"
}
}
}
}Public, URL-safe lifecycle identifier returned by list/search responses.
Public account identifier for the root account or subaccount the flow belongs to.
7563897446546Smart-account address for the account the flow belongs to. This is the stable address selector equivalent of `owner_account_id`; do not derive it from source or destination display addresses.
0x2222222222222222222222222222222222222222Public, URL-safe lifecycle identifier for display, URLs, and user search.
flow_7YWHMfk9JZeLMgZauHuiSxhIProduct flow family.
DEPOSITCurrent user-facing progress step for this flow. This may be derived from the flow state before a matching factual observed step exists.
SOURCEZipped asset identifier for the chain-specific asset mapping row. This is the canonical id from `chain_zipped_assets`, which already represents the source-chain asset metadata plus its mapped zToken relationship when relevant.
100Unified asset identifier for the uAsset used by funding or trading flows when relevant. This is the canonical Polyester asset identity used by FundingAccount, TradingGateway, Lending, and other downstream product domains.
100Polyester Chain id associated with this flow when known.
1Most significant 64 bits.
1Least significant 64 bits.
1Zipped asset identifier for the chain-specific asset mapping row. This is the canonical id from `chain_zipped_assets`, which already represents the source-chain asset metadata plus its mapped zToken relationship when relevant.
100Unified asset identifier for the uAsset used by funding or trading flows when relevant. This is the canonical Polyester asset identity used by FundingAccount, TradingGateway, Lending, and other downstream product domains.
100Most significant 64 bits.
1Least significant 64 bits.
1Fee recipient address when settled on chain.
0x3333333333333333333333333333333333333333Current state of the fee snapshot.
LOCKEDFirst observed source transaction hash for the flow when known.
0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890Stable occurrence discriminator within a transaction. For source-chain deposits this is the batched leg index; for on-chain facts it is the log or equivalent per-tx occurrence index when available.
1Source address to show for the overall flow. For internal transfers this is the source smart account address.
0x4444444444444444444444444444444444444444Destination address to show for the overall flow. For internal transfers this is the destination smart account address.
0x3333333333333333333333333333333333333333Latest transaction reference associated with the current visible state.
0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890Product domain where the overall flow starts. Use with `destination_domain` for route labels such as Funding to Trading.
EXTERNAL_CHAINProduct domain where the overall flow ends or currently settles. Do not derive route labels from per-step settlement activity.
EXTERNAL_CHAINProvenance of the latest meaningful lifecycle activity reflected in this summary. This is not necessarily the source of the entire flow.
RELAYERProduct-facing reason for failed, dropped, or otherwise notable flows.
ZIPPER_VALIDATION_REJECTEDStable code assigned to the specific outcome.
DEPOSIT_WAIT_EXPIREDStable reason identifier suitable for localization lookup.
valueUser-displayable English explanation of the outcome.
valueFirst observed business timestamp in milliseconds since epoch (UTC).
1Last summary update timestamp in milliseconds since epoch (UTC).
1Terminal timestamp in milliseconds since epoch (UTC), or zero while open.
1Timestamp used for list ordering in milliseconds since epoch (UTC).
1True when the flow is still progressing.
falseTrue when the flow reached a final state.
falseOne-based sequence of `current_step` in `progress_timeline`.
1Timestamp when the current visible step started, in milliseconds since epoch (UTC).
1Expected duration for the current visible step in milliseconds.
1Current source confirmation count when confirmations apply.
1Required source confirmation count when confirmations apply.
1Current approval count when validation applies.
1Current rejection count when validation applies.
1Validator set size when validation applies.
1Approval count required for the current validation step.
1Rejection count that would fail the current validation step.
1One-based sequence within the expected timeline.
1Visible lifecycle step.
SOURCEProgress status for this timeline item.
COMPLETEDExpected duration of this visible step in milliseconds, derived from recent observed timing data for the same flow type.
1Estimated Unix completion timestamp in milliseconds.
1One-based observed step sequence for display and audit.
1Business-facing observed step.
SOURCEZipped asset identifier for the chain-specific asset mapping row. This is the canonical id from `chain_zipped_assets`, which already represents the source-chain asset metadata plus its mapped zToken relationship when relevant.
100Unified asset identifier for the uAsset used by funding or trading flows when relevant. This is the canonical Polyester asset identity used by FundingAccount, TradingGateway, Lending, and other downstream product domains.
100Polyester Chain id associated with this step when known.
1Most significant 64 bits.
1Least significant 64 bits.
1Zipped asset identifier for the chain-specific asset mapping row. This is the canonical id from `chain_zipped_assets`, which already represents the source-chain asset metadata plus its mapped zToken relationship when relevant.
100Unified asset identifier for the uAsset used by funding or trading flows when relevant. This is the canonical Polyester asset identity used by FundingAccount, TradingGateway, Lending, and other downstream product domains.
100Most significant 64 bits.
1Least significant 64 bits.
1Fee recipient address when settled on chain.
0x3333333333333333333333333333333333333333Current state of the fee snapshot.
LOCKEDTransaction reference most relevant to this step.
0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890Source that produced this visible step.
RELAYERProduct-facing reason for failed, dropped, or otherwise notable steps.
ZIPPER_VALIDATION_REJECTEDStable code assigned to the specific outcome.
DEPOSIT_WAIT_EXPIREDStable reason identifier suitable for localization lookup.
valueUser-displayable English explanation of the outcome.
valueCurrent source confirmation count when confirmations apply.
1Required source confirmation count when confirmations apply.
1Current approval count when validation applies.
1Current rejection count when validation applies.
1Validator set size when validation applies.
1Approval count required for this validation step.
1Rejection count that would fail this validation step.
1Step occurrence timestamp in milliseconds since epoch (UTC).
1Source-chain block time moving average in milliseconds when known.
1Sequence of the underlying activity within the flow.
1Transaction reference associated with this activity.
0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890Activity occurrence timestamp in milliseconds since epoch (UTC).
1Source that produced this activity.
RELAYERProduct-facing reason for notable activity states.
ZIPPER_VALIDATION_REJECTEDStable code assigned to the specific outcome.
DEPOSIT_WAIT_EXPIREDStable reason identifier suitable for localization lookup.
valueUser-displayable English explanation of the outcome.
valueCurrent source confirmation count when confirmations apply.
1Required source confirmation count when confirmations apply.
1Current approval count when validation applies.
1Current rejection count when validation applies.
1Validator set size when validation applies.
1Activity kind for display grouping.
MINTEDApproval count required for this activity.
1Rejection count that would fail this activity.
1Most significant 64 bits.
1Least significant 64 bits.
1Ledger transfer identifier for ledger-sourced settlement activities.
9155001234568True when this detail was served from live in-memory state rather than historical terminal state.
false| Key | Status | Error | When |
|---|---|---|---|
| unauthenticated | 401 | Unauthenticated | Authentication required. |
| permission-denied | 403 | Permission Denied | Permission denied. |
| invalid-argument | 400 | Invalid Argument | Invalid argument. |
| not-found | 404 | Not Found | Not found. |
| unavailable | 503 | Unavailable | Service unavailable. |