@polyester/sdk 0.0.0

package/dist/gen/chain/lifecycle/v1/lifecycle_read_pb.d.ts

@@ -0,0 +1,1297 @@
+import { U128 } from "../../../polyester/type/v1/u128_pb.js";
+import { AssetIds, FlowDomain, FlowKind, FlowState, LifecycleReason, LifecycleSource, RequestFee } from "./types_pb.js";
+import { ZipperReasonDetails } from "../../zipper/v1/reason_pb.js";
+import { GenEnum, GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import { Message } from "@bufbuild/protobuf";
+declare namespace lifecycle_read_pb_d_exports {
+  export { FlowDetailView, FlowDetailViewSchema, FlowStep, FlowStepActivityKind, FlowStepActivityKindSchema, FlowStepActivityView, FlowStepActivityViewSchema, FlowStepSchema, FlowStepView, FlowStepViewSchema, FlowSummaryProgressView, FlowSummaryProgressViewSchema, FlowSummaryView, FlowSummaryViewSchema, FlowTimelineItemView, FlowTimelineItemViewSchema, FlowTimelineStatus, FlowTimelineStatusSchema, FlowTxMatchView, FlowTxMatchViewSchema, GetFlowByIdRequest, GetFlowByIdRequestSchema, GetFlowResponse, GetFlowResponseSchema, LifecycleReadService, ListFlowsByTxRequest, ListFlowsByTxRequestSchema, ListFlowsByTxResponse, ListFlowsByTxResponseSchema, ListFlowsRequest, ListFlowsRequestSchema, ListFlowsResponse, ListFlowsResponseSchema, ListOrderBy, ListOrderBySchema, ListScope, ListScopeSchema, Sort, SortSchema, TxLookupKind, TxLookupKindSchema, file_chain_lifecycle_v1_lifecycle_read };
+}
+/**
+ * Describes the file chain/lifecycle/v1/lifecycle_read.proto.
+ */
+declare const file_chain_lifecycle_v1_lifecycle_read: GenFile;
+/**
+ * GetFlowResponse returns one lifecycle flow with summary, factual steps, and
+ * estimated timeline data when available.
+ *
+ * @generated from message chain.lifecycle.v1.GetFlowResponse
+ */
+type GetFlowResponse = Message<"chain.lifecycle.v1.GetFlowResponse"> & {
+  /**
+   * Lifecycle flow detail for the requested intent id.
+   *
+   * @generated from field: chain.lifecycle.v1.FlowDetailView flow = 1;
+   */
+  flow?: FlowDetailView | undefined;
+};
+/**
+ * Describes the message chain.lifecycle.v1.GetFlowResponse.
+ * Use `create(GetFlowResponseSchema)` to create a new message.
+ */
+declare const GetFlowResponseSchema: GenMessage<GetFlowResponse>;
+/**
+ * GetFlowByIdRequest selects one lifecycle flow by its public flow id.
+ *
+ * @generated from message chain.lifecycle.v1.GetFlowByIdRequest
+ */
+type GetFlowByIdRequest = Message<"chain.lifecycle.v1.GetFlowByIdRequest"> & {
+  /**
+   * Public, URL-safe lifecycle identifier returned by list/search responses.
+   *
+   * @generated from field: string flow_id = 1;
+   */
+  flowId: string;
+};
+/**
+ * Describes the message chain.lifecycle.v1.GetFlowByIdRequest.
+ * Use `create(GetFlowByIdRequestSchema)` to create a new message.
+ */
+declare const GetFlowByIdRequestSchema: GenMessage<GetFlowByIdRequest>;
+/**
+ * ListFlowsByTxRequest searches lifecycle flows by transaction identifier. A
+ * single chain transaction can map to zero, one, or many lifecycle flows.
+ *
+ * @generated from message chain.lifecycle.v1.ListFlowsByTxRequest
+ */
+type ListFlowsByTxRequest = Message<"chain.lifecycle.v1.ListFlowsByTxRequest"> & {
+  /**
+   * Chain transaction identifier to search for. Accepts a 0x-prefixed 32-byte
+   * EVM hash or a printable chain-native transaction id such as a Solana
+   * signature, Bitcoin txid, Litecoin txid, Dogecoin txid, or XRP transaction
+   * hash.
+   *
+   * @generated from field: string tx_hash = 1;
+   */
+  txHash: string;
+  /**
+   * Lookup mode that determines which transaction references are searched.
+   *
+   * @generated from field: chain.lifecycle.v1.TxLookupKind lookup_kind = 2;
+   */
+  lookupKind: TxLookupKind;
+  /**
+   * Maximum number of matches to return. Defaults to 100 when omitted; maximum
+   * is 500.
+   *
+   * @generated from field: uint32 limit = 3;
+   */
+  limit: number;
+  /**
+   * Opaque keyset cursor returned by a previous response. The cursor is
+   * exclusive and bound to the transaction hash and lookup mode.
+   *
+   * @generated from field: string page_token = 4;
+   */
+  pageToken: string;
+};
+/**
+ * Describes the message chain.lifecycle.v1.ListFlowsByTxRequest.
+ * Use `create(ListFlowsByTxRequestSchema)` to create a new message.
+ */
+declare const ListFlowsByTxRequestSchema: GenMessage<ListFlowsByTxRequest>;
+/**
+ * ListFlowsRequest filters and paginates lifecycle flow summaries.
+ *
+ * @generated from message chain.lifecycle.v1.ListFlowsRequest
+ */
+type ListFlowsRequest = Message<"chain.lifecycle.v1.ListFlowsRequest"> & {
+  /**
+   * Maximum number of flows to return. Defaults to 100 when omitted; maximum is
+   * 500.
+   *
+   * @generated from field: uint32 limit = 1;
+   */
+  limit: number;
+  /**
+   * Sort direction for the selected ordering timestamp.
+   *
+   * @generated from field: chain.lifecycle.v1.Sort sort = 2;
+   */
+  sort: Sort;
+  /**
+   * Optional product flow kind filter. Unspecified includes all kinds.
+   *
+   * @generated from field: chain.lifecycle.v1.FlowKind flow_kind = 3;
+   */
+  flowKind: FlowKind;
+  /**
+   * Optional lifecycle state filter. Unspecified includes all states permitted
+   * by the selected scope.
+   *
+   * @generated from field: chain.lifecycle.v1.FlowState flow_state = 4;
+   */
+  flowState: FlowState;
+  /**
+   * Optional transaction reference filter. Matches source or latest activity
+   * transaction identifiers across supported chains.
+   *
+   * @generated from field: string tx_ref = 5;
+   */
+  txRef: string;
+  /**
+   * Selects open, terminal, or all lifecycle flows.
+   *
+   * @generated from field: chain.lifecycle.v1.ListScope scope = 6;
+   */
+  scope: ListScope;
+  /**
+   * Optional account selector. Omit to list across accounts the caller is
+   * allowed to inspect.
+   *
+   * @generated from oneof chain.lifecycle.v1.ListFlowsRequest.account_selector
+   */
+  accountSelector: {
+    /**
+     * Public account identifier for a main account or subaccount.
+     *
+     * @generated from field: fixed64 owner_account_id = 7;
+     */
+    value: bigint;
+    case: "ownerAccountId";
+  } | {
+    /**
+     * Smart account address on Polyester Chain.
+     *
+     * @generated from field: string smart_account_address = 8;
+     */
+    value: string;
+    case: "smartAccountAddress";
+  } | {
+    case: undefined;
+    value?: undefined;
+  };
+  /**
+   * Optional Polyester Chain ids to include. Maximum 100 unique ids.
+   *
+   * @generated from field: repeated uint32 polyester_chain_ids = 9;
+   */
+  polyesterChainIds: number[];
+  /**
+   * Optional chain asset mapping ids to include. Maximum 100 unique ids.
+   *
+   * @generated from field: repeated uint32 zipped_asset_ids = 10;
+   */
+  zippedAssetIds: number[];
+  /**
+   * Optional unified asset ids to include. Maximum 100 unique ids.
+   *
+   * @generated from field: repeated uint32 unified_asset_ids = 11;
+   */
+  unifiedAssetIds: number[];
+  /**
+   * Opaque keyset cursor returned by a previous response. The cursor is
+   * exclusive and bound to the caller, filters, account selector, sort
+   * direction, and ordering timestamp.
+   *
+   * @generated from field: string page_token = 12;
+   */
+  pageToken: string;
+  /**
+   * Timestamp used for ordering and pagination. Defaults to last activity.
+   *
+   * @generated from field: chain.lifecycle.v1.ListOrderBy order_by = 13;
+   */
+  orderBy: ListOrderBy;
+};
+/**
+ * Describes the message chain.lifecycle.v1.ListFlowsRequest.
+ * Use `create(ListFlowsRequestSchema)` to create a new message.
+ */
+declare const ListFlowsRequestSchema: GenMessage<ListFlowsRequest>;
+/**
+ * ListFlowsResponse returns one page of flow summaries.
+ *
+ * @generated from message chain.lifecycle.v1.ListFlowsResponse
+ */
+type ListFlowsResponse = Message<"chain.lifecycle.v1.ListFlowsResponse"> & {
+  /**
+   * Flow summaries ordered by the selected timestamp, then public flow id. Sort
+   * direction is controlled by the request `sort` field.
+   *
+   * @generated from field: repeated chain.lifecycle.v1.FlowSummaryView flows = 1;
+   */
+  flows: FlowSummaryView[];
+  /**
+   * Opaque cursor for the next page. Empty when no more results exist.
+   *
+   * @generated from field: string next_page_token = 2;
+   */
+  nextPageToken: string;
+};
+/**
+ * Describes the message chain.lifecycle.v1.ListFlowsResponse.
+ * Use `create(ListFlowsResponseSchema)` to create a new message.
+ */
+declare const ListFlowsResponseSchema: GenMessage<ListFlowsResponse>;
+/**
+ * FlowTxMatchView is one lifecycle flow matched by a transaction-hash search.
+ *
+ * @generated from message chain.lifecycle.v1.FlowTxMatchView
+ */
+type FlowTxMatchView = Message<"chain.lifecycle.v1.FlowTxMatchView"> & {
+  /**
+   * Public, URL-safe lifecycle identifier for display, URLs, and user search.
+   *
+   * @generated from field: string flow_id = 1;
+   */
+  flowId: string;
+  /**
+   * Product flow family.
+   *
+   * @generated from field: chain.lifecycle.v1.FlowKind flow_kind = 3;
+   */
+  flowKind: FlowKind;
+  /**
+   * First observed source transaction hash for the flow when known.
+   *
+   * @generated from field: string source_tx_hash = 4;
+   */
+  sourceTxHash: string;
+  /**
+   * Latest transaction reference associated with the current visible state.
+   *
+   * @generated from field: string latest_tx_ref = 5;
+   */
+  latestTxRef: string;
+  /**
+   * Stable 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.
+   *
+   * @generated from field: uint64 tx_occurrence_index = 6;
+   */
+  txOccurrenceIndex: bigint;
+  /**
+   * Product domain where the overall flow starts.
+   *
+   * @generated from field: chain.lifecycle.v1.FlowDomain source_domain = 7;
+   */
+  sourceDomain: FlowDomain;
+  /**
+   * Product domain where the overall flow ends or currently settles.
+   *
+   * @generated from field: chain.lifecycle.v1.FlowDomain destination_domain = 8;
+   */
+  destinationDomain: FlowDomain;
+  /**
+   * Current user-facing progress step for this flow.
+   *
+   * @generated from field: chain.lifecycle.v1.FlowStep current_step = 9;
+   */
+  currentStep: FlowStep;
+  /**
+   * True when this flow is still progressing.
+   *
+   * @generated from field: bool is_open = 10;
+   */
+  isOpen: boolean;
+  /**
+   * True when this flow reached a final state.
+   *
+   * @generated from field: bool is_terminal = 11;
+   */
+  isTerminal: boolean;
+  /**
+   * Asset identifiers involved in this flow.
+   *
+   * @generated from field: chain.lifecycle.v1.AssetIds asset_ids = 12;
+   */
+  assetIds?: AssetIds | undefined;
+  /**
+   * Polyester Chain id associated with this flow.
+   *
+   * @generated from field: uint32 polyester_chain_id = 13;
+   */
+  polyesterChainId: number;
+  /**
+   * Gross principal amount for this flow in 18-decimal unified asset units.
+   *
+   * @generated from field: polyester.type.v1.U128 amount_e18 = 14;
+   */
+  amountE18?: U128 | undefined;
+  /**
+   * Source address to show for this flow.
+   *
+   * @generated from field: string source_address = 15;
+   */
+  sourceAddress: string;
+  /**
+   * Destination address to show for this flow.
+   *
+   * @generated from field: string destination_address = 16;
+   */
+  destinationAddress: string;
+  /**
+   * Product-facing reason for failed, dropped, or otherwise notable flows.
+   *
+   * @generated from field: chain.lifecycle.v1.LifecycleReason lifecycle_reason = 17;
+   */
+  lifecycleReason: LifecycleReason;
+  /**
+   * Timestamp used for list ordering in milliseconds since epoch (UTC).
+   *
+   * @generated from field: uint64 last_activity_at_unix_ms = 18;
+   */
+  lastActivityAtUnixMs: bigint;
+  /**
+   * Public account or subaccount identifier that owns this flow.
+   *
+   * @generated from field: fixed64 owner_account_id = 19;
+   */
+  ownerAccountId: bigint;
+  /**
+   * Smart account address on Polyester Chain when known.
+   *
+   * @generated from field: string smart_account_address = 20;
+   */
+  smartAccountAddress: string;
+  /**
+   * Specific reason details when a notable outcome has a catalog entry.
+   *
+   * @generated from field: chain.zipper.v1.ZipperReasonDetails zipper_reason = 21;
+   */
+  zipperReason?: ZipperReasonDetails | undefined;
+};
+/**
+ * Describes the message chain.lifecycle.v1.FlowTxMatchView.
+ * Use `create(FlowTxMatchViewSchema)` to create a new message.
+ */
+declare const FlowTxMatchViewSchema: GenMessage<FlowTxMatchView>;
+/**
+ * ListFlowsByTxResponse returns a page of lifecycle flows that reference one
+ * transaction hash.
+ *
+ * @generated from message chain.lifecycle.v1.ListFlowsByTxResponse
+ */
+type ListFlowsByTxResponse = Message<"chain.lifecycle.v1.ListFlowsByTxResponse"> & {
+  /**
+   * Transaction hash searched by the request.
+   *
+   * @generated from field: string tx_hash = 1;
+   */
+  txHash: string;
+  /**
+   * Matching flows ordered by tx occurrence, flow kind, domains, activity time,
+   * and stable identifiers.
+   *
+   * @generated from field: repeated chain.lifecycle.v1.FlowTxMatchView matches = 2;
+   */
+  matches: FlowTxMatchView[];
+  /**
+   * Opaque cursor for the next page. Empty when no more results exist.
+   *
+   * @generated from field: string next_page_token = 3;
+   */
+  nextPageToken: string;
+};
+/**
+ * Describes the message chain.lifecycle.v1.ListFlowsByTxResponse.
+ * Use `create(ListFlowsByTxResponseSchema)` to create a new message.
+ */
+declare const ListFlowsByTxResponseSchema: GenMessage<ListFlowsByTxResponse>;
+/**
+ * FlowSummaryView is the compact lifecycle representation used by lists,
+ * realtime updates, and the header of a detail view.
+ *
+ * @generated from message chain.lifecycle.v1.FlowSummaryView
+ */
+type FlowSummaryView = Message<"chain.lifecycle.v1.FlowSummaryView"> & {
+  /**
+   * Public account identifier for the root account or subaccount the flow belongs to.
+   *
+   * @generated from field: fixed64 owner_account_id = 1;
+   */
+  ownerAccountId: bigint;
+  /**
+   * Smart-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.
+   *
+   * @generated from field: string smart_account_address = 34;
+   */
+  smartAccountAddress: string;
+  /**
+   * Public, URL-safe lifecycle identifier for display, URLs, and user search.
+   *
+   * @generated from field: string flow_id = 33;
+   */
+  flowId: string;
+  /**
+   * Product flow family.
+   *
+   * @generated from field: chain.lifecycle.v1.FlowKind flow_kind = 4;
+   */
+  flowKind: FlowKind;
+  /**
+   * Current user-facing progress step for this flow. This may be derived from
+   * the flow state before a matching factual observed step exists.
+   *
+   * @generated from field: chain.lifecycle.v1.FlowStep current_step = 6;
+   */
+  currentStep: FlowStep;
+  /**
+   * Asset identifiers involved in the flow.
+   *
+   * @generated from field: chain.lifecycle.v1.AssetIds asset_ids = 7;
+   */
+  assetIds?: AssetIds | undefined;
+  /**
+   * Polyester Chain id associated with this flow when known.
+   *
+   * @generated from field: uint32 polyester_chain_id = 8;
+   */
+  polyesterChainId: number;
+  /**
+   * Gross principal amount for the flow in 18-decimal unified asset units.
+   * Request fees are exposed separately in request_fee. Specific fulfillment
+   * steps may carry a net movement amount when the step represents external
+   * delivery.
+   *
+   * @generated from field: polyester.type.v1.U128 amount_e18 = 9;
+   */
+  amountE18?: U128 | undefined;
+  /**
+   * Request-scoped fee details when a fee applies and should be visible for the
+   * current step.
+   *
+   * @generated from field: chain.lifecycle.v1.RequestFee request_fee = 28;
+   */
+  requestFee?: RequestFee | undefined;
+  /**
+   * First observed source transaction hash for the flow when known.
+   *
+   * @generated from field: string source_tx_hash = 11;
+   */
+  sourceTxHash: string;
+  /**
+   * Stable 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.
+   *
+   * @generated from field: uint64 tx_occurrence_index = 32;
+   */
+  txOccurrenceIndex: bigint;
+  /**
+   * Source address to show for the overall flow. For internal transfers this is
+   * the source smart account address.
+   *
+   * @generated from field: string source_address = 13;
+   */
+  sourceAddress: string;
+  /**
+   * Destination address to show for the overall flow. For internal transfers
+   * this is the destination smart account address.
+   *
+   * @generated from field: string destination_address = 14;
+   */
+  destinationAddress: string;
+  /**
+   * Latest transaction reference associated with the current visible state.
+   *
+   * @generated from field: string latest_tx_ref = 15;
+   */
+  latestTxRef: string;
+  /**
+   * Product domain where the overall flow starts. Use with
+   * `destination_domain` for route labels such as Funding to Trading.
+   *
+   * @generated from field: chain.lifecycle.v1.FlowDomain source_domain = 29;
+   */
+  sourceDomain: FlowDomain;
+  /**
+   * Product domain where the overall flow ends or currently settles. Do not
+   * derive route labels from per-step settlement activity.
+   *
+   * @generated from field: chain.lifecycle.v1.FlowDomain destination_domain = 30;
+   */
+  destinationDomain: FlowDomain;
+  /**
+   * Provenance of the latest meaningful lifecycle activity reflected in this
+   * summary. This is not necessarily the source of the entire flow.
+   *
+   * @generated from field: chain.lifecycle.v1.LifecycleSource latest_lifecycle_source = 16;
+   */
+  latestLifecycleSource: LifecycleSource;
+  /**
+   * Product-facing reason for failed, dropped, or otherwise notable flows.
+   *
+   * @generated from field: chain.lifecycle.v1.LifecycleReason lifecycle_reason = 17;
+   */
+  lifecycleReason: LifecycleReason;
+  /**
+   * Specific reason details when a notable outcome has a catalog entry.
+   *
+   * @generated from field: chain.zipper.v1.ZipperReasonDetails zipper_reason = 35;
+   */
+  zipperReason?: ZipperReasonDetails | undefined;
+  /**
+   * First observed business timestamp in milliseconds since epoch (UTC).
+   *
+   * @generated from field: uint64 started_at_unix_ms = 18;
+   */
+  startedAtUnixMs: bigint;
+  /**
+   * Last summary update timestamp in milliseconds since epoch (UTC).
+   *
+   * @generated from field: uint64 updated_at_unix_ms = 19;
+   */
+  updatedAtUnixMs: bigint;
+  /**
+   * Terminal timestamp in milliseconds since epoch (UTC), or zero while open.
+   *
+   * @generated from field: uint64 terminal_at_unix_ms = 20;
+   */
+  terminalAtUnixMs: bigint;
+  /**
+   * Timestamp used for list ordering in milliseconds since epoch (UTC).
+   *
+   * @generated from field: uint64 last_activity_at_unix_ms = 21;
+   */
+  lastActivityAtUnixMs: bigint;
+  /**
+   * True when the flow is still progressing.
+   *
+   * @generated from field: bool is_open = 22;
+   */
+  isOpen: boolean;
+  /**
+   * True when the flow reached a final state.
+   *
+   * @generated from field: bool is_terminal = 23;
+   */
+  isTerminal: boolean;
+  /**
+   * One-based sequence of `current_step` in `progress_timeline`.
+   *
+   * @generated from field: uint32 current_step_sequence = 24;
+   */
+  currentStepSequence: number;
+  /**
+   * Progress data for the current visible step when the flow is open.
+   *
+   * @generated from field: chain.lifecycle.v1.FlowSummaryProgressView current_progress = 25;
+   */
+  currentProgress?: FlowSummaryProgressView | undefined;
+  /**
+   * Progress-bar timeline for list/header UI. This timeline may include a
+   * current derived step that is ahead of the latest factual observed step.
+   *
+   * @generated from field: repeated chain.lifecycle.v1.FlowTimelineItemView progress_timeline = 26;
+   */
+  progressTimeline: FlowTimelineItemView[];
+  /**
+   * Estimated Unix completion timestamp in milliseconds.
+   *
+   * @generated from field: uint64 estimated_completion_unix_ms = 27;
+   */
+  estimatedCompletionUnixMs: bigint;
+};
+/**
+ * Describes the message chain.lifecycle.v1.FlowSummaryView.
+ * Use `create(FlowSummaryViewSchema)` to create a new message.
+ */
+declare const FlowSummaryViewSchema: GenMessage<FlowSummaryView>;
+/**
+ * FlowSummaryProgressView describes progress within the current visible step.
+ *
+ * @generated from message chain.lifecycle.v1.FlowSummaryProgressView
+ */
+type FlowSummaryProgressView = Message<"chain.lifecycle.v1.FlowSummaryProgressView"> & {
+  /**
+   * Timestamp when the current visible step started, in milliseconds since epoch
+   * (UTC).
+   *
+   * @generated from field: uint64 current_step_started_at_unix_ms = 1;
+   */
+  currentStepStartedAtUnixMs: bigint;
+  /**
+   * Expected duration for the current visible step in milliseconds.
+   *
+   * @generated from field: uint64 current_step_expected_duration_ms = 2;
+   */
+  currentStepExpectedDurationMs: bigint;
+  /**
+   * Current source confirmation count when confirmations apply.
+   *
+   * @generated from field: uint32 current_confirmations = 5;
+   */
+  currentConfirmations: number;
+  /**
+   * Required source confirmation count when confirmations apply.
+   *
+   * @generated from field: uint32 required_confirmations = 6;
+   */
+  requiredConfirmations: number;
+  /**
+   * Current approval count when validation applies.
+   *
+   * @generated from field: uint32 approve_count = 7;
+   */
+  approveCount: number;
+  /**
+   * Current rejection count when validation applies.
+   *
+   * @generated from field: uint32 reject_count = 8;
+   */
+  rejectCount: number;
+  /**
+   * Validator set size when validation applies.
+   *
+   * @generated from field: uint32 validator_count = 9;
+   */
+  validatorCount: number;
+  /**
+   * Approval count required for the current validation step.
+   *
+   * @generated from field: uint32 required_approvals = 10;
+   */
+  requiredApprovals: number;
+  /**
+   * Rejection count that would fail the current validation step.
+   *
+   * @generated from field: uint32 required_rejections = 11;
+   */
+  requiredRejections: number;
+};
+/**
+ * Describes the message chain.lifecycle.v1.FlowSummaryProgressView.
+ * Use `create(FlowSummaryProgressViewSchema)` to create a new message.
+ */
+declare const FlowSummaryProgressViewSchema: GenMessage<FlowSummaryProgressView>;
+/**
+ * FlowStepView is one factual observed visible step in the lifecycle detail
+ * view. Use `FlowSummaryView.progress_timeline` for the current projected
+ * progress state.
+ *
+ * @generated from message chain.lifecycle.v1.FlowStepView
+ */
+type FlowStepView = Message<"chain.lifecycle.v1.FlowStepView"> & {
+  /**
+   * One-based observed step sequence for display and audit.
+   *
+   * @generated from field: uint32 sequence = 1;
+   */
+  sequence: number;
+  /**
+   * Business-facing observed step.
+   *
+   * @generated from field: chain.lifecycle.v1.FlowStep step = 3;
+   */
+  step: FlowStep;
+  /**
+   * Asset identifiers involved in this step.
+   *
+   * @generated from field: chain.lifecycle.v1.AssetIds asset_ids = 7;
+   */
+  assetIds?: AssetIds | undefined;
+  /**
+   * Polyester Chain id associated with this step when known.
+   *
+   * @generated from field: uint32 polyester_chain_id = 8;
+   */
+  polyesterChainId: number;
+  /**
+   * Amount represented by this step in 18-decimal unified asset units. Steps
+   * may carry the actual net movement amount when fees have already been taken.
+   *
+   * @generated from field: polyester.type.v1.U128 amount_e18 = 9;
+   */
+  amountE18?: U128 | undefined;
+  /**
+   * Request-scoped fee details when a fee applies to this step.
+   *
+   * @generated from field: chain.lifecycle.v1.RequestFee request_fee = 24;
+   */
+  requestFee?: RequestFee | undefined;
+  /**
+   * Transaction reference most relevant to this step.
+   *
+   * @generated from field: string milestone_tx_ref = 11;
+   */
+  milestoneTxRef: string;
+  /**
+   * Source that produced this visible step.
+   *
+   * @generated from field: chain.lifecycle.v1.LifecycleSource lifecycle_source = 12;
+   */
+  lifecycleSource: LifecycleSource;
+  /**
+   * Product-facing reason for failed, dropped, or otherwise notable steps.
+   *
+   * @generated from field: chain.lifecycle.v1.LifecycleReason lifecycle_reason = 13;
+   */
+  lifecycleReason: LifecycleReason;
+  /**
+   * Specific reason details when a notable outcome has a catalog entry.
+   *
+   * @generated from field: chain.zipper.v1.ZipperReasonDetails zipper_reason = 25;
+   */
+  zipperReason?: ZipperReasonDetails | undefined;
+  /**
+   * Current source confirmation count when confirmations apply.
+   *
+   * @generated from field: uint32 current_confirmations = 14;
+   */
+  currentConfirmations: number;
+  /**
+   * Required source confirmation count when confirmations apply.
+   *
+   * @generated from field: uint32 required_confirmations = 15;
+   */
+  requiredConfirmations: number;
+  /**
+   * Current approval count when validation applies.
+   *
+   * @generated from field: uint32 approve_count = 16;
+   */
+  approveCount: number;
+  /**
+   * Current rejection count when validation applies.
+   *
+   * @generated from field: uint32 reject_count = 17;
+   */
+  rejectCount: number;
+  /**
+   * Validator set size when validation applies.
+   *
+   * @generated from field: uint32 validator_count = 18;
+   */
+  validatorCount: number;
+  /**
+   * Approval count required for this validation step.
+   *
+   * @generated from field: uint32 required_approvals = 22;
+   */
+  requiredApprovals: number;
+  /**
+   * Rejection count that would fail this validation step.
+   *
+   * @generated from field: uint32 required_rejections = 23;
+   */
+  requiredRejections: number;
+  /**
+   * Step occurrence timestamp in milliseconds since epoch (UTC).
+   *
+   * @generated from field: uint64 occurred_at_unix_ms = 19;
+   */
+  occurredAtUnixMs: bigint;
+  /**
+   * Source-chain block time moving average in milliseconds when known.
+   *
+   * @generated from field: uint64 block_time_moving_average_ms = 20;
+   */
+  blockTimeMovingAverageMs: bigint;
+  /**
+   * Nested activity rows for expandable UI detail. The top-level step remains
+   * one visible lifecycle stage while activities expose the underlying on-chain
+   * evidence that advanced it.
+   *
+   * @generated from field: repeated chain.lifecycle.v1.FlowStepActivityView activities = 21;
+   */
+  activities: FlowStepActivityView[];
+};
+/**
+ * Describes the message chain.lifecycle.v1.FlowStepView.
+ * Use `create(FlowStepViewSchema)` to create a new message.
+ */
+declare const FlowStepViewSchema: GenMessage<FlowStepView>;
+/**
+ * FlowStepActivityView is an expandable detail row underneath a visible step.
+ *
+ * @generated from message chain.lifecycle.v1.FlowStepActivityView
+ */
+type FlowStepActivityView = Message<"chain.lifecycle.v1.FlowStepActivityView"> & {
+  /**
+   * Sequence of the underlying activity within the flow.
+   *
+   * @generated from field: uint32 sequence = 1;
+   */
+  sequence: number;
+  /**
+   * Transaction reference associated with this activity.
+   *
+   * @generated from field: string tx_ref = 2;
+   */
+  txRef: string;
+  /**
+   * Activity occurrence timestamp in milliseconds since epoch (UTC).
+   *
+   * @generated from field: uint64 occurred_at_unix_ms = 3;
+   */
+  occurredAtUnixMs: bigint;
+  /**
+   * Source that produced this activity.
+   *
+   * @generated from field: chain.lifecycle.v1.LifecycleSource lifecycle_source = 4;
+   */
+  lifecycleSource: LifecycleSource;
+  /**
+   * Product-facing reason for notable activity states.
+   *
+   * @generated from field: chain.lifecycle.v1.LifecycleReason lifecycle_reason = 5;
+   */
+  lifecycleReason: LifecycleReason;
+  /**
+   * Specific reason details when a notable outcome has a catalog entry.
+   *
+   * @generated from field: chain.zipper.v1.ZipperReasonDetails zipper_reason = 16;
+   */
+  zipperReason?: ZipperReasonDetails | undefined;
+  /**
+   * Current source confirmation count when confirmations apply.
+   *
+   * @generated from field: uint32 current_confirmations = 6;
+   */
+  currentConfirmations: number;
+  /**
+   * Required source confirmation count when confirmations apply.
+   *
+   * @generated from field: uint32 required_confirmations = 7;
+   */
+  requiredConfirmations: number;
+  /**
+   * Current approval count when validation applies.
+   *
+   * @generated from field: uint32 approve_count = 8;
+   */
+  approveCount: number;
+  /**
+   * Current rejection count when validation applies.
+   *
+   * @generated from field: uint32 reject_count = 9;
+   */
+  rejectCount: number;
+  /**
+   * Validator set size when validation applies.
+   *
+   * @generated from field: uint32 validator_count = 10;
+   */
+  validatorCount: number;
+  /**
+   * Activity kind for display grouping.
+   *
+   * @generated from field: chain.lifecycle.v1.FlowStepActivityKind kind = 11;
+   */
+  kind: FlowStepActivityKind;
+  /**
+   * Approval count required for this activity.
+   *
+   * @generated from field: uint32 required_approvals = 12;
+   */
+  requiredApprovals: number;
+  /**
+   * Rejection count that would fail this activity.
+   *
+   * @generated from field: uint32 required_rejections = 13;
+   */
+  requiredRejections: number;
+  /**
+   * Amount posted by the underlying movement represented by this activity, in
+   * 18-decimal unified asset units. This may be a net movement amount for
+   * fee-bearing fulfillment activity.
+   *
+   * @generated from field: polyester.type.v1.U128 amount_e18 = 14;
+   */
+  amountE18?: U128 | undefined;
+  /**
+   * Ledger transfer identifier for ledger-sourced settlement activities.
+   *
+   * @generated from field: string ledger_transfer_id = 15;
+   */
+  ledgerTransferId: string;
+};
+/**
+ * Describes the message chain.lifecycle.v1.FlowStepActivityView.
+ * Use `create(FlowStepActivityViewSchema)` to create a new message.
+ */
+declare const FlowStepActivityViewSchema: GenMessage<FlowStepActivityView>;
+/**
+ * FlowTimelineItemView is one item in the expected visible lifecycle progress
+ * path.
+ *
+ * @generated from message chain.lifecycle.v1.FlowTimelineItemView
+ */
+type FlowTimelineItemView = Message<"chain.lifecycle.v1.FlowTimelineItemView"> & {
+  /**
+   * One-based sequence within the expected timeline.
+   *
+   * @generated from field: uint32 sequence = 1;
+   */
+  sequence: number;
+  /**
+   * Visible lifecycle step.
+   *
+   * @generated from field: chain.lifecycle.v1.FlowStep step = 2;
+   */
+  step: FlowStep;
+  /**
+   * Progress status for this timeline item.
+   *
+   * @generated from field: chain.lifecycle.v1.FlowTimelineStatus status = 3;
+   */
+  status: FlowTimelineStatus;
+  /**
+   * Expected duration of this visible step in milliseconds, derived from recent
+   * observed timing data for the same flow type.
+   *
+   * @generated from field: uint64 expected_duration_ms = 4;
+   */
+  expectedDurationMs: bigint;
+};
+/**
+ * Describes the message chain.lifecycle.v1.FlowTimelineItemView.
+ * Use `create(FlowTimelineItemViewSchema)` to create a new message.
+ */
+declare const FlowTimelineItemViewSchema: GenMessage<FlowTimelineItemView>;
+/**
+ * FlowDetailView is the full lifecycle detail response model.
+ *
+ * @generated from message chain.lifecycle.v1.FlowDetailView
+ */
+type FlowDetailView = Message<"chain.lifecycle.v1.FlowDetailView"> & {
+  /**
+   * Compact flow summary for headers and list-style display.
+   *
+   * @generated from field: chain.lifecycle.v1.FlowSummaryView summary = 1;
+   */
+  summary?: FlowSummaryView | undefined;
+  /**
+   * Factual visible steps observed for this flow, ordered by sequence. Open
+   * flows may have `summary.current_step` ahead of the last observed step.
+   *
+   * @generated from field: repeated chain.lifecycle.v1.FlowStepView observed_steps = 2;
+   */
+  observedSteps: FlowStepView[];
+  /**
+   * True when this detail was served from live in-memory state rather than
+   * historical terminal state.
+   *
+   * @generated from field: bool from_live_state = 3;
+   */
+  fromLiveState: boolean;
+};
+/**
+ * Describes the message chain.lifecycle.v1.FlowDetailView.
+ * Use `create(FlowDetailViewSchema)` to create a new message.
+ */
+declare const FlowDetailViewSchema: GenMessage<FlowDetailView>;
+/**
+ * TxLookupKind controls which transaction reference fields are searched.
+ *
+ * @generated from enum chain.lifecycle.v1.TxLookupKind
+ */
+declare enum TxLookupKind {
+  /**
+   * Lookup mode was not specified.
+   *
+   * @generated from enum value: TX_UNSPECIFIED = 0;
+   */
+  TX_UNSPECIFIED = 0,
+  /**
+   * Match only the original source transaction hash for a flow.
+   *
+   * @generated from enum value: TX_SOURCE = 1;
+   */
+  TX_SOURCE = 1,
+  /**
+   * Match either the source transaction hash or the latest known activity
+   * transaction reference.
+   *
+   * @generated from enum value: TX_ANY = 2;
+   */
+  TX_ANY = 2
+}
+/**
+ * Describes the enum chain.lifecycle.v1.TxLookupKind.
+ */
+declare const TxLookupKindSchema: GenEnum<TxLookupKind>;
+/**
+ * ListScope selects which lifecycle state bucket should be returned.
+ *
+ * @generated from enum chain.lifecycle.v1.ListScope
+ */
+declare enum ListScope {
+  /**
+   * No explicit scope; server defaults decide which buckets are included.
+   *
+   * @generated from enum value: LIST_UNSPECIFIED = 0;
+   */
+  LIST_UNSPECIFIED = 0,
+  /**
+   * Include both open and terminal flows.
+   *
+   * @generated from enum value: LIST_ALL = 1;
+   */
+  LIST_ALL = 1,
+  /**
+   * Include only flows that are still progressing.
+   *
+   * @generated from enum value: LIST_OPEN_ONLY = 2;
+   */
+  LIST_OPEN_ONLY = 2,
+  /**
+   * Include only flows that reached a terminal state.
+   *
+   * @generated from enum value: LIST_TERMINAL_ONLY = 3;
+   */
+  LIST_TERMINAL_ONLY = 3
+}
+/**
+ * Describes the enum chain.lifecycle.v1.ListScope.
+ */
+declare const ListScopeSchema: GenEnum<ListScope>;
+/**
+ * Sort selects lifecycle list direction.
+ *
+ * @generated from enum chain.lifecycle.v1.Sort
+ */
+declare enum Sort {
+  /**
+   * Sort order was not specified; server defaults apply.
+   *
+   * @generated from enum value: SORT_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+  /**
+   * Return newest rows first for the selected ordering timestamp.
+   *
+   * @generated from enum value: SORT_NEWEST = 1;
+   */
+  NEWEST = 1,
+  /**
+   * Return oldest rows first for the selected ordering timestamp.
+   *
+   * @generated from enum value: SORT_OLDEST = 2;
+   */
+  OLDEST = 2
+}
+/**
+ * Describes the enum chain.lifecycle.v1.Sort.
+ */
+declare const SortSchema: GenEnum<Sort>;
+/**
+ * ListOrderBy selects which timestamp ListFlows uses for ordering and cursors.
+ *
+ * @generated from enum chain.lifecycle.v1.ListOrderBy
+ */
+declare enum ListOrderBy {
+  /**
+   * Ordering timestamp was not specified; server defaults to last activity.
+   *
+   * @generated from enum value: ORDER_BY_UNSPECIFIED = 0;
+   */
+  ORDER_BY_UNSPECIFIED = 0,
+  /**
+   * Order by the latest lifecycle activity timestamp.
+   *
+   * @generated from enum value: ORDER_BY_LAST_ACTIVITY = 1;
+   */
+  ORDER_BY_LAST_ACTIVITY = 1,
+  /**
+   * Order by the first observed business timestamp. Rows without a start time
+   * use their terminal timestamp when available.
+   *
+   * @generated from enum value: ORDER_BY_STARTED_AT = 2;
+   */
+  ORDER_BY_STARTED_AT = 2
+}
+/**
+ * Describes the enum chain.lifecycle.v1.ListOrderBy.
+ */
+declare const ListOrderBySchema: GenEnum<ListOrderBy>;
+/**
+ * FlowStep is the public lifecycle step shown in API and realtime read
+ * models. It is business-facing and intentionally hides the lower-level
+ * technical milestone taxonomy.
+ *
+ * @generated from enum chain.lifecycle.v1.FlowStep
+ */
+declare enum FlowStep {
+  /**
+   * Step is not specified.
+   *
+   * @generated from enum value: FLOW_STEP_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+  /**
+   * External-chain / relayer source tracking before Polyester can continue.
+   *
+   * @generated from enum value: FLOW_STEP_SOURCE = 1;
+   */
+  SOURCE = 1,
+  /**
+   * Deposit-side mint and downstream crediting / transfer stage.
+   *
+   * @generated from enum value: FLOW_STEP_TRANSFER = 2;
+   */
+  TRANSFER = 2,
+  /**
+   * Polyester request creation stage.
+   *
+   * @generated from enum value: FLOW_STEP_REQUEST = 3;
+   */
+  REQUEST = 3,
+  /**
+   * Polyester validation / quorum stage.
+   *
+   * @generated from enum value: FLOW_STEP_VALIDATION = 4;
+   */
+  VALIDATION = 4,
+  /**
+   * Polyester execution stage.
+   *
+   * @generated from enum value: FLOW_STEP_EXECUTION = 5;
+   */
+  EXECUTION = 5,
+  /**
+   * Bridge fulfillment before final ledger settlement.
+   *
+   * @generated from enum value: FLOW_STEP_BRIDGE_FULFILLMENT = 6;
+   */
+  BRIDGE_FULFILLMENT = 6,
+  /**
+   * Flow was dropped before success.
+   *
+   * @generated from enum value: FLOW_STEP_DROPPED = 7;
+   */
+  DROPPED = 7,
+  /**
+   * Flow failed in a user-visible way.
+   *
+   * @generated from enum value: FLOW_STEP_FAILED = 8;
+   */
+  FAILED = 8,
+  /**
+   * Flow reached a refund or reversal result.
+   *
+   * @generated from enum value: FLOW_STEP_REFUNDED = 9;
+   */
+  REFUNDED = 9,
+  /**
+   * Withdraw destination tx hash was committed and the flow is waiting for the
+   * final fulfillment confirmation.
+   *
+   * @generated from enum value: FLOW_STEP_FULFILLING = 10;
+   */
+  FULFILLING = 10,
+  /**
+   * Off-chain ledger settlement was durably confirmed.
+   *
+   * @generated from enum value: FLOW_STEP_SETTLEMENT = 11;
+   */
+  SETTLEMENT = 11
+}
+/**
+ * Describes the enum chain.lifecycle.v1.FlowStep.
+ */
+declare const FlowStepSchema: GenEnum<FlowStep>;
+/**
+ * @generated from enum chain.lifecycle.v1.FlowStepActivityKind
+ */
+declare enum FlowStepActivityKind {
+  /**
+   * Activity kind is not specified.
+   *
+   * @generated from enum value: ACTIVITY_UNSPECIFIED = 0;
+   */
+  ACTIVITY_UNSPECIFIED = 0,
+  /**
+   * Mapped asset was minted on Polyester Chain.
+   *
+   * @generated from enum value: ACTIVITY_MINTED = 1;
+   */
+  ACTIVITY_MINTED = 1,
+  /**
+   * Funding account received the credit.
+   *
+   * @generated from enum value: ACTIVITY_FUNDING = 2;
+   */
+  ACTIVITY_FUNDING = 2,
+  /**
+   * Trading account received the credit.
+   *
+   * @generated from enum value: ACTIVITY_TRADING = 3;
+   */
+  ACTIVITY_TRADING = 3
+}
+/**
+ * Describes the enum chain.lifecycle.v1.FlowStepActivityKind.
+ */
+declare const FlowStepActivityKindSchema: GenEnum<FlowStepActivityKind>;
+/**
+ * FlowTimelineStatus describes how a progress timeline item relates to the
+ * current user-facing flow state.
+ *
+ * @generated from enum chain.lifecycle.v1.FlowTimelineStatus
+ */
+declare enum FlowTimelineStatus {
+  /**
+   * Timeline status is not specified.
+   *
+   * @generated from enum value: TIMELINE_STATUS_UNSPECIFIED = 0;
+   */
+  TIMELINE_STATUS_UNSPECIFIED = 0,
+  /**
+   * Step has been observed or is behind the current progress step.
+   *
+   * @generated from enum value: TIMELINE_STATUS_COMPLETED = 1;
+   */
+  TIMELINE_STATUS_COMPLETED = 1,
+  /**
+   * Step is the current active progress step.
+   *
+   * @generated from enum value: TIMELINE_STATUS_CURRENT = 2;
+   */
+  TIMELINE_STATUS_CURRENT = 2,
+  /**
+   * Step is expected but has not been observed yet.
+   *
+   * @generated from enum value: TIMELINE_STATUS_PLANNED = 3;
+   */
+  TIMELINE_STATUS_PLANNED = 3
+}
+/**
+ * Describes the enum chain.lifecycle.v1.FlowTimelineStatus.
+ */
+declare const FlowTimelineStatusSchema: GenEnum<FlowTimelineStatus>;
+/**
+ * LifecycleReadService exposes lifecycle flow lookup and listing APIs.
+ *
+ * @generated from service chain.lifecycle.v1.LifecycleReadService
+ */
+declare const LifecycleReadService: GenService<{
+  /**
+   * GetFlowById retrieves one lifecycle flow by public flow id.
+   *
+   * @generated from rpc chain.lifecycle.v1.LifecycleReadService.GetFlowById
+   */
+  getFlowById: {
+    methodKind: "unary";
+    input: typeof GetFlowByIdRequestSchema;
+    output: typeof GetFlowResponseSchema;
+  };
+  /**
+   * ListFlows lists lifecycle flows with optional filters and keyset
+   * pagination.
+   *
+   * @generated from rpc chain.lifecycle.v1.LifecycleReadService.ListFlows
+   */
+  listFlows: {
+    methodKind: "unary";
+    input: typeof ListFlowsRequestSchema;
+    output: typeof ListFlowsResponseSchema;
+  };
+  /**
+   * ListFlowsByTx lists lifecycle flows that reference a transaction hash.
+   *
+   * @generated from rpc chain.lifecycle.v1.LifecycleReadService.ListFlowsByTx
+   */
+  listFlowsByTx: {
+    methodKind: "unary";
+    input: typeof ListFlowsByTxRequestSchema;
+    output: typeof ListFlowsByTxResponseSchema;
+  };
+}>;
+//#endregion
+export { FlowDetailView, FlowDetailViewSchema, FlowStep, FlowStepActivityKind, FlowStepActivityKindSchema, FlowStepActivityView, FlowStepActivityViewSchema, FlowStepSchema, FlowStepView, FlowStepViewSchema, FlowSummaryProgressView, FlowSummaryProgressViewSchema, FlowSummaryView, FlowSummaryViewSchema, FlowTimelineItemView, FlowTimelineItemViewSchema, FlowTimelineStatus, FlowTimelineStatusSchema, FlowTxMatchView, FlowTxMatchViewSchema, GetFlowByIdRequest, GetFlowByIdRequestSchema, GetFlowResponse, GetFlowResponseSchema, LifecycleReadService, ListFlowsByTxRequest, ListFlowsByTxRequestSchema, ListFlowsByTxResponse, ListFlowsByTxResponseSchema, ListFlowsRequest, ListFlowsRequestSchema, ListFlowsResponse, ListFlowsResponseSchema, ListOrderBy, ListOrderBySchema, ListScope, ListScopeSchema, Sort, SortSchema, TxLookupKind, TxLookupKindSchema, file_chain_lifecycle_v1_lifecycle_read, lifecycle_read_pb_d_exports };
+//# sourceMappingURL=lifecycle_read_pb.d.ts.map