From 5f9a47197144537d9b20ab6e272f3aaa4d154ac1 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Mon, 17 Nov 2025 16:07:08 +0000 Subject: [PATCH 01/16] chore: auto-convert OpenAPI YAML to JSON --- api-reference/trails-api.gen.json | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/api-reference/trails-api.gen.json b/api-reference/trails-api.gen.json index c01a90f..7a91439 100644 --- a/api-reference/trails-api.gen.json +++ b/api-reference/trails-api.gen.json @@ -1426,6 +1426,36 @@ "LZ_RECEIVE" ] }, + "IntentStatus": { + "type": "string", + "description": "Represented as uint8 on the server side", + "enum": [ + "QUOTED", + "COMMITTED", + "EXECUTING", + "FAILED", + "SUCCEEDED" + ] + }, + "TransactionType": { + "type": "string", + "description": "Represented as uint8 on the server side", + "enum": [ + "UNKNOWN", + "DEPOSIT", + "ORIGIN", + "DESTINATION", + "ROUTE" + ] + }, + "TransactionContext": { + "type": "string", + "description": "Represented as uint8 on the server side", + "enum": [ + "NONE", + "CCTPV2_MESSAGE" + ] + }, "TransactionStatus": { "type": "string", "description": "Represented as uint8 on the server side", From 832f802bab6fc610f0af710656c453fb62735a1c Mon Sep 17 00:00:00 2001 From: pkieltyka <18831+pkieltyka@users.noreply.github.com> Date: Fri, 28 Nov 2025 14:57:18 +0000 Subject: [PATCH 02/16] [AUTOMATED] Update: proto/docs/trails-api.gen.yaml --- api-reference/trails-api.gen.yaml | 3 +++ 1 file changed, 3 insertions(+) diff --git a/api-reference/trails-api.gen.yaml b/api-reference/trails-api.gen.yaml index 76af96d..08300e1 100644 --- a/api-reference/trails-api.gen.yaml +++ b/api-reference/trails-api.gen.yaml @@ -2384,9 +2384,12 @@ components: type: object required: - intent + - trailsContracts properties: intent: $ref: '#/components/schemas/Intent' + trailsContracts: + $ref: '#/components/schemas/TrailsContracts' CommitIntentResponse: type: object required: From d2f6c8f9c78f16df954a84204874c7af90651554 Mon Sep 17 00:00:00 2001 From: pkieltyka <18831+pkieltyka@users.noreply.github.com> Date: Thu, 4 Dec 2025 12:51:32 +0000 Subject: [PATCH 03/16] [AUTOMATED] Update: proto/docs/trails-api.gen.yaml --- api-reference/trails-api.gen.yaml | 3 --- 1 file changed, 3 deletions(-) diff --git a/api-reference/trails-api.gen.yaml b/api-reference/trails-api.gen.yaml index 08300e1..76af96d 100644 --- a/api-reference/trails-api.gen.yaml +++ b/api-reference/trails-api.gen.yaml @@ -2384,12 +2384,9 @@ components: type: object required: - intent - - trailsContracts properties: intent: $ref: '#/components/schemas/Intent' - trailsContracts: - $ref: '#/components/schemas/TrailsContracts' CommitIntentResponse: type: object required: From 5a414428bd8085d5548ef571d38252023d5d02dd Mon Sep 17 00:00:00 2001 From: pkieltyka <18831+pkieltyka@users.noreply.github.com> Date: Thu, 18 Dec 2025 15:07:32 +0000 Subject: [PATCH 04/16] [AUTOMATED] Update: proto/docs/trails-api.gen.yaml --- api-reference/trails-api.gen.yaml | 1 - 1 file changed, 1 deletion(-) diff --git a/api-reference/trails-api.gen.yaml b/api-reference/trails-api.gen.yaml index 76af96d..693a450 100644 --- a/api-reference/trails-api.gen.yaml +++ b/api-reference/trails-api.gen.yaml @@ -1067,7 +1067,6 @@ components: - SUCCEEDED - FAILED - ABORTED - - REVERTED ChainGasUsageStatus: type: string description: Represented as string on the server side From 851353af4388336a992eae7142a519f21c9f945e Mon Sep 17 00:00:00 2001 From: pkieltyka <18831+pkieltyka@users.noreply.github.com> Date: Tue, 23 Dec 2025 03:05:09 +0000 Subject: [PATCH 05/16] [AUTOMATED] Update: proto/docs/trails-api.gen.yaml --- api-reference/trails-api.gen.yaml | 1 + 1 file changed, 1 insertion(+) diff --git a/api-reference/trails-api.gen.yaml b/api-reference/trails-api.gen.yaml index 693a450..76af96d 100644 --- a/api-reference/trails-api.gen.yaml +++ b/api-reference/trails-api.gen.yaml @@ -1067,6 +1067,7 @@ components: - SUCCEEDED - FAILED - ABORTED + - REVERTED ChainGasUsageStatus: type: string description: Represented as string on the server side From e0bb5d68776cae4dd8de945a443ce7f576cb545d Mon Sep 17 00:00:00 2001 From: shunkakinoki <39187513+shunkakinoki@users.noreply.github.com> Date: Tue, 13 Jan 2026 10:52:28 +0000 Subject: [PATCH 06/16] [AUTOMATED] Update: proto/docs/trails-api.gen.yaml --- api-reference/trails-api.gen.yaml | 36 +++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) diff --git a/api-reference/trails-api.gen.yaml b/api-reference/trails-api.gen.yaml index 76af96d..91ccee4 100644 --- a/api-reference/trails-api.gen.yaml +++ b/api-reference/trails-api.gen.yaml @@ -1974,6 +1974,42 @@ components: type: string currencyType: type: string + RelayTransfer: + type: object + required: + - id + - intentId + - originChainId + - destinationChainId + - originTxnId + - originTxnHash + - destinationTxnId + - status + - createdAt + - updatedAt + properties: + id: + type: number + intentId: + type: string + originChainId: + type: number + destinationChainId: + type: number + originTxnId: + type: number + originTxnHash: + type: string + destinationTxnId: + type: number + status: + type: number + statusReason: + type: string + createdAt: + type: string + updatedAt: + type: string GasFeeOptions: type: object required: From a85d31b3eba54f8fbcd51feb557a338375bf15c9 Mon Sep 17 00:00:00 2001 From: shunkakinoki <39187513+shunkakinoki@users.noreply.github.com> Date: Tue, 13 Jan 2026 20:52:53 +0000 Subject: [PATCH 07/16] [AUTOMATED] Update: proto/docs/trails-api.gen.yaml --- api-reference/trails-api.gen.yaml | 3 +++ 1 file changed, 3 insertions(+) diff --git a/api-reference/trails-api.gen.yaml b/api-reference/trails-api.gen.yaml index 91ccee4..088a28a 100644 --- a/api-reference/trails-api.gen.yaml +++ b/api-reference/trails-api.gen.yaml @@ -1984,6 +1984,7 @@ components: - originTxnId - originTxnHash - destinationTxnId + - destinationTxnHash - status - createdAt - updatedAt @@ -2002,6 +2003,8 @@ components: type: string destinationTxnId: type: number + destinationTxnHash: + type: string status: type: number statusReason: From f4315610ef33f1e17158a6444181fc4a34066643 Mon Sep 17 00:00:00 2001 From: pkieltyka <18831+pkieltyka@users.noreply.github.com> Date: Tue, 10 Mar 2026 19:29:25 +0000 Subject: [PATCH 08/16] [AUTOMATED] Update: proto/docs/trails-api.gen.yaml --- api-reference/trails-api.gen.yaml | 71 +++++++++++++++++++++++++++++++ 1 file changed, 71 insertions(+) diff --git a/api-reference/trails-api.gen.yaml b/api-reference/trails-api.gen.yaml index 088a28a..4356250 100644 --- a/api-reference/trails-api.gen.yaml +++ b/api-reference/trails-api.gen.yaml @@ -4545,6 +4545,77 @@ paths: - $ref: '#/components/schemas/ErrorWebrpcInternalError' - $ref: '#/components/schemas/ErrorUnexpected' - $ref: '#/components/schemas/ErrorChainNodeHealth' + /rpc/Trails/GetSupportedIntentProtocols: + post: + operationId: Trails-GetSupportedIntentProtocols + tags: ["Trails"] + summary: "" + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/Trails_GetSupportedIntentProtocols_Request' + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/Trails_GetSupportedIntentProtocols_Response' + '4XX': + description: Client error + content: + application/json: + schema: + oneOf: + - $ref: '#/components/schemas/ErrorWebrpcEndpoint' + - $ref: '#/components/schemas/ErrorWebrpcRequestFailed' + - $ref: '#/components/schemas/ErrorWebrpcBadRoute' + - $ref: '#/components/schemas/ErrorWebrpcBadMethod' + - $ref: '#/components/schemas/ErrorWebrpcBadRequest' + - $ref: '#/components/schemas/ErrorWebrpcClientAborted' + - $ref: '#/components/schemas/ErrorWebrpcStreamLost' + - $ref: '#/components/schemas/ErrorUnauthorized' + - $ref: '#/components/schemas/ErrorPermissionDenied' + - $ref: '#/components/schemas/ErrorSessionExpired' + - $ref: '#/components/schemas/ErrorMethodNotFound' + - $ref: '#/components/schemas/ErrorRequestConflict' + - $ref: '#/components/schemas/ErrorAborted' + - $ref: '#/components/schemas/ErrorGeoblocked' + - $ref: '#/components/schemas/ErrorRateLimited' + - $ref: '#/components/schemas/ErrorProjectNotFound' + - $ref: '#/components/schemas/ErrorAccessKeyNotFound' + - $ref: '#/components/schemas/ErrorAccessKeyMismatch' + - $ref: '#/components/schemas/ErrorInvalidOrigin' + - $ref: '#/components/schemas/ErrorInvalidService' + - $ref: '#/components/schemas/ErrorUnauthorizedUser' + - $ref: '#/components/schemas/ErrorQuotaExceeded' + - $ref: '#/components/schemas/ErrorQuotaRateLimit' + - $ref: '#/components/schemas/ErrorNoDefaultKey' + - $ref: '#/components/schemas/ErrorMaxAccessKeys' + - $ref: '#/components/schemas/ErrorAtLeastOneKey' + - $ref: '#/components/schemas/ErrorTimeout' + - $ref: '#/components/schemas/ErrorInvalidArgument' + - $ref: '#/components/schemas/ErrorUnavailable' + - $ref: '#/components/schemas/ErrorQueryFailed' + - $ref: '#/components/schemas/ErrorIntentStatus' + - $ref: '#/components/schemas/ErrorNotFound' + - $ref: '#/components/schemas/ErrorUnsupportedNetwork' + - $ref: '#/components/schemas/ErrorClientOutdated' + - $ref: '#/components/schemas/ErrorIntentsSkipped' + - $ref: '#/components/schemas/ErrorQuoteExpired' + - $ref: '#/components/schemas/ErrorIntentsDisabled' + '5XX': + description: Server error + content: + application/json: + schema: + oneOf: + - $ref: '#/components/schemas/ErrorWebrpcBadResponse' + - $ref: '#/components/schemas/ErrorWebrpcServerPanic' + - $ref: '#/components/schemas/ErrorWebrpcInternalError' + - $ref: '#/components/schemas/ErrorUnexpected' + - $ref: '#/components/schemas/ErrorChainNodeHealth' /rpc/Trails/GetEarnPools: post: operationId: Trails-GetEarnPools From 66182643ea34774fcb4030a19049b98b4763f5a9 Mon Sep 17 00:00:00 2001 From: pkieltyka <18831+pkieltyka@users.noreply.github.com> Date: Mon, 16 Mar 2026 23:44:46 +0000 Subject: [PATCH 09/16] [AUTOMATED] Update: proto/docs/trails-api.gen.yaml --- api-reference/trails-api.gen.yaml | 71 +++++++++++++++++++++++++++++++ 1 file changed, 71 insertions(+) diff --git a/api-reference/trails-api.gen.yaml b/api-reference/trails-api.gen.yaml index 4356250..6c27a38 100644 --- a/api-reference/trails-api.gen.yaml +++ b/api-reference/trails-api.gen.yaml @@ -4545,6 +4545,77 @@ paths: - $ref: '#/components/schemas/ErrorWebrpcInternalError' - $ref: '#/components/schemas/ErrorUnexpected' - $ref: '#/components/schemas/ErrorChainNodeHealth' + /rpc/Trails/GetProtocolContracts: + post: + operationId: Trails-GetProtocolContracts + tags: ["Trails"] + summary: "GetProtocolContracts returns Trails contract addresses used by the Trails Intents stack for the given protocol." + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/Trails_GetProtocolContracts_Request' + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/Trails_GetProtocolContracts_Response' + '4XX': + description: Client error + content: + application/json: + schema: + oneOf: + - $ref: '#/components/schemas/ErrorWebrpcEndpoint' + - $ref: '#/components/schemas/ErrorWebrpcRequestFailed' + - $ref: '#/components/schemas/ErrorWebrpcBadRoute' + - $ref: '#/components/schemas/ErrorWebrpcBadMethod' + - $ref: '#/components/schemas/ErrorWebrpcBadRequest' + - $ref: '#/components/schemas/ErrorWebrpcClientAborted' + - $ref: '#/components/schemas/ErrorWebrpcStreamLost' + - $ref: '#/components/schemas/ErrorUnauthorized' + - $ref: '#/components/schemas/ErrorPermissionDenied' + - $ref: '#/components/schemas/ErrorSessionExpired' + - $ref: '#/components/schemas/ErrorMethodNotFound' + - $ref: '#/components/schemas/ErrorRequestConflict' + - $ref: '#/components/schemas/ErrorAborted' + - $ref: '#/components/schemas/ErrorGeoblocked' + - $ref: '#/components/schemas/ErrorRateLimited' + - $ref: '#/components/schemas/ErrorProjectNotFound' + - $ref: '#/components/schemas/ErrorAccessKeyNotFound' + - $ref: '#/components/schemas/ErrorAccessKeyMismatch' + - $ref: '#/components/schemas/ErrorInvalidOrigin' + - $ref: '#/components/schemas/ErrorInvalidService' + - $ref: '#/components/schemas/ErrorUnauthorizedUser' + - $ref: '#/components/schemas/ErrorQuotaExceeded' + - $ref: '#/components/schemas/ErrorQuotaRateLimit' + - $ref: '#/components/schemas/ErrorNoDefaultKey' + - $ref: '#/components/schemas/ErrorMaxAccessKeys' + - $ref: '#/components/schemas/ErrorAtLeastOneKey' + - $ref: '#/components/schemas/ErrorTimeout' + - $ref: '#/components/schemas/ErrorInvalidArgument' + - $ref: '#/components/schemas/ErrorUnavailable' + - $ref: '#/components/schemas/ErrorQueryFailed' + - $ref: '#/components/schemas/ErrorIntentStatus' + - $ref: '#/components/schemas/ErrorNotFound' + - $ref: '#/components/schemas/ErrorUnsupportedNetwork' + - $ref: '#/components/schemas/ErrorClientOutdated' + - $ref: '#/components/schemas/ErrorIntentsSkipped' + - $ref: '#/components/schemas/ErrorQuoteExpired' + - $ref: '#/components/schemas/ErrorIntentsDisabled' + '5XX': + description: Server error + content: + application/json: + schema: + oneOf: + - $ref: '#/components/schemas/ErrorWebrpcBadResponse' + - $ref: '#/components/schemas/ErrorWebrpcServerPanic' + - $ref: '#/components/schemas/ErrorWebrpcInternalError' + - $ref: '#/components/schemas/ErrorUnexpected' + - $ref: '#/components/schemas/ErrorChainNodeHealth' /rpc/Trails/GetSupportedIntentProtocols: post: operationId: Trails-GetSupportedIntentProtocols From db9a99f677a8b3c26ec2875f476d1fb4f1d8dc54 Mon Sep 17 00:00:00 2001 From: pkieltyka <18831+pkieltyka@users.noreply.github.com> Date: Thu, 19 Mar 2026 13:48:15 +0000 Subject: [PATCH 10/16] [AUTOMATED] Update: proto/docs/trails-api.gen.yaml --- api-reference/trails-api.gen.yaml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/api-reference/trails-api.gen.yaml b/api-reference/trails-api.gen.yaml index 6c27a38..4b8eefd 100644 --- a/api-reference/trails-api.gen.yaml +++ b/api-reference/trails-api.gen.yaml @@ -4604,6 +4604,7 @@ paths: - $ref: '#/components/schemas/ErrorClientOutdated' - $ref: '#/components/schemas/ErrorIntentsSkipped' - $ref: '#/components/schemas/ErrorQuoteExpired' + - $ref: '#/components/schemas/ErrorHighPriceImpact' - $ref: '#/components/schemas/ErrorIntentsDisabled' '5XX': description: Server error @@ -4675,6 +4676,7 @@ paths: - $ref: '#/components/schemas/ErrorClientOutdated' - $ref: '#/components/schemas/ErrorIntentsSkipped' - $ref: '#/components/schemas/ErrorQuoteExpired' + - $ref: '#/components/schemas/ErrorHighPriceImpact' - $ref: '#/components/schemas/ErrorIntentsDisabled' '5XX': description: Server error From 76a5e35bf03a2a69d53f30a03d0d32f42f9e165f Mon Sep 17 00:00:00 2001 From: pkieltyka <18831+pkieltyka@users.noreply.github.com> Date: Tue, 31 Mar 2026 17:23:29 +0000 Subject: [PATCH 11/16] [AUTOMATED] Update: proto/docs/trails-api.gen.yaml --- api-reference/trails-api.gen.yaml | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/api-reference/trails-api.gen.yaml b/api-reference/trails-api.gen.yaml index 4b8eefd..58683ac 100644 --- a/api-reference/trails-api.gen.yaml +++ b/api-reference/trails-api.gen.yaml @@ -1,4 +1,4 @@ -# trails-api v1 e5f7fc952d694046c813590e0141426137e6aa71 +# trails-api v1 afb12298fbfbb321e3c14c2cde12a278757b55c3 # -- # Code generated by webrpc-gen@v0.36.1 with openapi generator; DO NOT EDIT # @@ -2078,9 +2078,7 @@ components: DepositSignature: type: object required: - - intentSignature - selectedGasFeeOption - - userNonce - deadline properties: intentSignature: @@ -2100,11 +2098,9 @@ components: DepositIntentEntry: type: object required: - - intentSignature - feeAmount - feeToken - feeCollector - - userNonce - deadline properties: intentSignature: @@ -2144,6 +2140,7 @@ components: - trailsIntentEntrypointAddress - trailsRouterAddress - trailsRouterShimAddress + - trailsUtilsAddress properties: trailsIntentEntrypointAddress: type: string @@ -2151,6 +2148,8 @@ components: type: string trailsRouterShimAddress: type: string + trailsUtilsAddress: + type: string NativeCurrency: type: object required: From bffc2f7eb4d59fab05cd02153b5052463fdaa2d0 Mon Sep 17 00:00:00 2001 From: pkieltyka <18831+pkieltyka@users.noreply.github.com> Date: Wed, 1 Apr 2026 19:38:25 +0000 Subject: [PATCH 12/16] [AUTOMATED] Update: proto/docs/trails-api.gen.yaml --- api-reference/trails-api.gen.yaml | 601 +++++++++++++++++++++++++++++- 1 file changed, 600 insertions(+), 1 deletion(-) diff --git a/api-reference/trails-api.gen.yaml b/api-reference/trails-api.gen.yaml index 58683ac..2450180 100644 --- a/api-reference/trails-api.gen.yaml +++ b/api-reference/trails-api.gen.yaml @@ -1,4 +1,4 @@ -# trails-api v1 afb12298fbfbb321e3c14c2cde12a278757b55c3 +# trails-api v1 34edef67f3d439e1eca97dc7aa887642e49df57e # -- # Code generated by webrpc-gen@v0.36.1 with openapi generator; DO NOT EDIT # @@ -995,6 +995,7 @@ components: enum: - AUTO - CCTP + - GASZIP - LIFI - LZ_OFT - RELAY @@ -2752,6 +2753,100 @@ components: type: string cached: type: boolean + GetYieldProvidersRequest: + type: object + properties: + limit: + type: number + offset: + type: number + GetYieldProvidersResponse: + type: object + required: + - payload + properties: + payload: + type: string + GetYieldProviderRequest: + type: object + required: + - providerId + properties: + providerId: + type: string + GetYieldProviderResponse: + type: object + required: + - payload + properties: + payload: + type: string + GetYieldNetworksRequest: + type: object + GetYieldNetworksResponse: + type: object + required: + - payload + properties: + payload: + type: string + GetYieldMarketsRequest: + type: object + properties: + provider: + type: string + chainId: + type: string + type: + type: string + search: + type: string + sort: + type: string + limit: + type: number + offset: + type: number + GetYieldMarketsResponse: + type: object + required: + - payload + properties: + payload: + type: string + GetYieldMarketByIdRequest: + type: object + required: + - marketId + properties: + marketId: + type: string + GetYieldMarketByIdResponse: + type: object + required: + - payload + properties: + payload: + type: string + CreateYieldActionRequest: + type: object + required: + - earnMarketId + - userWalletAddress + properties: + earnMarketId: + type: string + userWalletAddress: + type: string + args: + type: object + CreateYieldActionResponse: + type: object + required: + - payload + properties: + payload: + type: string GetIntentTransactionHistoryRequest: type: object properties: @@ -4762,6 +4857,510 @@ paths: - $ref: '#/components/schemas/ErrorWebrpcInternalError' - $ref: '#/components/schemas/ErrorUnexpected' - $ref: '#/components/schemas/ErrorChainNodeHealth' + /rpc/Trails/YieldGetProviders: + post: + operationId: Trails-YieldGetProviders + tags: ["Trails"] + summary: "YieldGetProviders returns available Yield providers." + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/GetYieldProvidersRequest' + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/GetYieldProvidersResponse' + '4XX': + description: Client error + content: + application/json: + schema: + oneOf: + - $ref: '#/components/schemas/ErrorWebrpcEndpoint' + - $ref: '#/components/schemas/ErrorWebrpcRequestFailed' + - $ref: '#/components/schemas/ErrorWebrpcBadRoute' + - $ref: '#/components/schemas/ErrorWebrpcBadMethod' + - $ref: '#/components/schemas/ErrorWebrpcBadRequest' + - $ref: '#/components/schemas/ErrorWebrpcClientAborted' + - $ref: '#/components/schemas/ErrorWebrpcStreamLost' + - $ref: '#/components/schemas/ErrorUnauthorized' + - $ref: '#/components/schemas/ErrorPermissionDenied' + - $ref: '#/components/schemas/ErrorSessionExpired' + - $ref: '#/components/schemas/ErrorMethodNotFound' + - $ref: '#/components/schemas/ErrorRequestConflict' + - $ref: '#/components/schemas/ErrorAborted' + - $ref: '#/components/schemas/ErrorGeoblocked' + - $ref: '#/components/schemas/ErrorRateLimited' + - $ref: '#/components/schemas/ErrorProjectNotFound' + - $ref: '#/components/schemas/ErrorAccessKeyNotFound' + - $ref: '#/components/schemas/ErrorAccessKeyMismatch' + - $ref: '#/components/schemas/ErrorInvalidOrigin' + - $ref: '#/components/schemas/ErrorInvalidService' + - $ref: '#/components/schemas/ErrorUnauthorizedUser' + - $ref: '#/components/schemas/ErrorQuotaExceeded' + - $ref: '#/components/schemas/ErrorQuotaRateLimit' + - $ref: '#/components/schemas/ErrorNoDefaultKey' + - $ref: '#/components/schemas/ErrorMaxAccessKeys' + - $ref: '#/components/schemas/ErrorAtLeastOneKey' + - $ref: '#/components/schemas/ErrorTimeout' + - $ref: '#/components/schemas/ErrorInvalidArgument' + - $ref: '#/components/schemas/ErrorUnavailable' + - $ref: '#/components/schemas/ErrorQueryFailed' + - $ref: '#/components/schemas/ErrorIntentStatus' + - $ref: '#/components/schemas/ErrorNotFound' + - $ref: '#/components/schemas/ErrorUnsupportedNetwork' + - $ref: '#/components/schemas/ErrorClientOutdated' + - $ref: '#/components/schemas/ErrorIntentsSkipped' + - $ref: '#/components/schemas/ErrorQuoteExpired' + - $ref: '#/components/schemas/ErrorHighPriceImpact' + - $ref: '#/components/schemas/ErrorIntentsDisabled' + '5XX': + description: Server error + content: + application/json: + schema: + oneOf: + - $ref: '#/components/schemas/ErrorWebrpcBadResponse' + - $ref: '#/components/schemas/ErrorWebrpcServerPanic' + - $ref: '#/components/schemas/ErrorWebrpcInternalError' + - $ref: '#/components/schemas/ErrorUnexpected' + - $ref: '#/components/schemas/ErrorChainNodeHealth' + /rpc/Trails/YieldGetProvider: + post: + operationId: Trails-YieldGetProvider + tags: ["Trails"] + summary: "YieldGetProvider returns a Yield provider by provider ID." + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/GetYieldProviderRequest' + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/GetYieldProviderResponse' + '4XX': + description: Client error + content: + application/json: + schema: + oneOf: + - $ref: '#/components/schemas/ErrorWebrpcEndpoint' + - $ref: '#/components/schemas/ErrorWebrpcRequestFailed' + - $ref: '#/components/schemas/ErrorWebrpcBadRoute' + - $ref: '#/components/schemas/ErrorWebrpcBadMethod' + - $ref: '#/components/schemas/ErrorWebrpcBadRequest' + - $ref: '#/components/schemas/ErrorWebrpcClientAborted' + - $ref: '#/components/schemas/ErrorWebrpcStreamLost' + - $ref: '#/components/schemas/ErrorUnauthorized' + - $ref: '#/components/schemas/ErrorPermissionDenied' + - $ref: '#/components/schemas/ErrorSessionExpired' + - $ref: '#/components/schemas/ErrorMethodNotFound' + - $ref: '#/components/schemas/ErrorRequestConflict' + - $ref: '#/components/schemas/ErrorAborted' + - $ref: '#/components/schemas/ErrorGeoblocked' + - $ref: '#/components/schemas/ErrorRateLimited' + - $ref: '#/components/schemas/ErrorProjectNotFound' + - $ref: '#/components/schemas/ErrorAccessKeyNotFound' + - $ref: '#/components/schemas/ErrorAccessKeyMismatch' + - $ref: '#/components/schemas/ErrorInvalidOrigin' + - $ref: '#/components/schemas/ErrorInvalidService' + - $ref: '#/components/schemas/ErrorUnauthorizedUser' + - $ref: '#/components/schemas/ErrorQuotaExceeded' + - $ref: '#/components/schemas/ErrorQuotaRateLimit' + - $ref: '#/components/schemas/ErrorNoDefaultKey' + - $ref: '#/components/schemas/ErrorMaxAccessKeys' + - $ref: '#/components/schemas/ErrorAtLeastOneKey' + - $ref: '#/components/schemas/ErrorTimeout' + - $ref: '#/components/schemas/ErrorInvalidArgument' + - $ref: '#/components/schemas/ErrorUnavailable' + - $ref: '#/components/schemas/ErrorQueryFailed' + - $ref: '#/components/schemas/ErrorIntentStatus' + - $ref: '#/components/schemas/ErrorNotFound' + - $ref: '#/components/schemas/ErrorUnsupportedNetwork' + - $ref: '#/components/schemas/ErrorClientOutdated' + - $ref: '#/components/schemas/ErrorIntentsSkipped' + - $ref: '#/components/schemas/ErrorQuoteExpired' + - $ref: '#/components/schemas/ErrorHighPriceImpact' + - $ref: '#/components/schemas/ErrorIntentsDisabled' + '5XX': + description: Server error + content: + application/json: + schema: + oneOf: + - $ref: '#/components/schemas/ErrorWebrpcBadResponse' + - $ref: '#/components/schemas/ErrorWebrpcServerPanic' + - $ref: '#/components/schemas/ErrorWebrpcInternalError' + - $ref: '#/components/schemas/ErrorUnexpected' + - $ref: '#/components/schemas/ErrorChainNodeHealth' + /rpc/Trails/YieldGetNetworks: + post: + operationId: Trails-YieldGetNetworks + tags: ["Trails"] + summary: "YieldGetNetworks returns available Yield networks." + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/GetYieldNetworksRequest' + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/GetYieldNetworksResponse' + '4XX': + description: Client error + content: + application/json: + schema: + oneOf: + - $ref: '#/components/schemas/ErrorWebrpcEndpoint' + - $ref: '#/components/schemas/ErrorWebrpcRequestFailed' + - $ref: '#/components/schemas/ErrorWebrpcBadRoute' + - $ref: '#/components/schemas/ErrorWebrpcBadMethod' + - $ref: '#/components/schemas/ErrorWebrpcBadRequest' + - $ref: '#/components/schemas/ErrorWebrpcClientAborted' + - $ref: '#/components/schemas/ErrorWebrpcStreamLost' + - $ref: '#/components/schemas/ErrorUnauthorized' + - $ref: '#/components/schemas/ErrorPermissionDenied' + - $ref: '#/components/schemas/ErrorSessionExpired' + - $ref: '#/components/schemas/ErrorMethodNotFound' + - $ref: '#/components/schemas/ErrorRequestConflict' + - $ref: '#/components/schemas/ErrorAborted' + - $ref: '#/components/schemas/ErrorGeoblocked' + - $ref: '#/components/schemas/ErrorRateLimited' + - $ref: '#/components/schemas/ErrorProjectNotFound' + - $ref: '#/components/schemas/ErrorAccessKeyNotFound' + - $ref: '#/components/schemas/ErrorAccessKeyMismatch' + - $ref: '#/components/schemas/ErrorInvalidOrigin' + - $ref: '#/components/schemas/ErrorInvalidService' + - $ref: '#/components/schemas/ErrorUnauthorizedUser' + - $ref: '#/components/schemas/ErrorQuotaExceeded' + - $ref: '#/components/schemas/ErrorQuotaRateLimit' + - $ref: '#/components/schemas/ErrorNoDefaultKey' + - $ref: '#/components/schemas/ErrorMaxAccessKeys' + - $ref: '#/components/schemas/ErrorAtLeastOneKey' + - $ref: '#/components/schemas/ErrorTimeout' + - $ref: '#/components/schemas/ErrorInvalidArgument' + - $ref: '#/components/schemas/ErrorUnavailable' + - $ref: '#/components/schemas/ErrorQueryFailed' + - $ref: '#/components/schemas/ErrorIntentStatus' + - $ref: '#/components/schemas/ErrorNotFound' + - $ref: '#/components/schemas/ErrorUnsupportedNetwork' + - $ref: '#/components/schemas/ErrorClientOutdated' + - $ref: '#/components/schemas/ErrorIntentsSkipped' + - $ref: '#/components/schemas/ErrorQuoteExpired' + - $ref: '#/components/schemas/ErrorHighPriceImpact' + - $ref: '#/components/schemas/ErrorIntentsDisabled' + '5XX': + description: Server error + content: + application/json: + schema: + oneOf: + - $ref: '#/components/schemas/ErrorWebrpcBadResponse' + - $ref: '#/components/schemas/ErrorWebrpcServerPanic' + - $ref: '#/components/schemas/ErrorWebrpcInternalError' + - $ref: '#/components/schemas/ErrorUnexpected' + - $ref: '#/components/schemas/ErrorChainNodeHealth' + /rpc/Trails/YieldGetMarkets: + post: + operationId: Trails-YieldGetMarkets + tags: ["Trails"] + summary: "YieldGetMarkets returns Yield markets with optional filters." + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/GetYieldMarketsRequest' + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/GetYieldMarketsResponse' + '4XX': + description: Client error + content: + application/json: + schema: + oneOf: + - $ref: '#/components/schemas/ErrorWebrpcEndpoint' + - $ref: '#/components/schemas/ErrorWebrpcRequestFailed' + - $ref: '#/components/schemas/ErrorWebrpcBadRoute' + - $ref: '#/components/schemas/ErrorWebrpcBadMethod' + - $ref: '#/components/schemas/ErrorWebrpcBadRequest' + - $ref: '#/components/schemas/ErrorWebrpcClientAborted' + - $ref: '#/components/schemas/ErrorWebrpcStreamLost' + - $ref: '#/components/schemas/ErrorUnauthorized' + - $ref: '#/components/schemas/ErrorPermissionDenied' + - $ref: '#/components/schemas/ErrorSessionExpired' + - $ref: '#/components/schemas/ErrorMethodNotFound' + - $ref: '#/components/schemas/ErrorRequestConflict' + - $ref: '#/components/schemas/ErrorAborted' + - $ref: '#/components/schemas/ErrorGeoblocked' + - $ref: '#/components/schemas/ErrorRateLimited' + - $ref: '#/components/schemas/ErrorProjectNotFound' + - $ref: '#/components/schemas/ErrorAccessKeyNotFound' + - $ref: '#/components/schemas/ErrorAccessKeyMismatch' + - $ref: '#/components/schemas/ErrorInvalidOrigin' + - $ref: '#/components/schemas/ErrorInvalidService' + - $ref: '#/components/schemas/ErrorUnauthorizedUser' + - $ref: '#/components/schemas/ErrorQuotaExceeded' + - $ref: '#/components/schemas/ErrorQuotaRateLimit' + - $ref: '#/components/schemas/ErrorNoDefaultKey' + - $ref: '#/components/schemas/ErrorMaxAccessKeys' + - $ref: '#/components/schemas/ErrorAtLeastOneKey' + - $ref: '#/components/schemas/ErrorTimeout' + - $ref: '#/components/schemas/ErrorInvalidArgument' + - $ref: '#/components/schemas/ErrorUnavailable' + - $ref: '#/components/schemas/ErrorQueryFailed' + - $ref: '#/components/schemas/ErrorIntentStatus' + - $ref: '#/components/schemas/ErrorNotFound' + - $ref: '#/components/schemas/ErrorUnsupportedNetwork' + - $ref: '#/components/schemas/ErrorClientOutdated' + - $ref: '#/components/schemas/ErrorIntentsSkipped' + - $ref: '#/components/schemas/ErrorQuoteExpired' + - $ref: '#/components/schemas/ErrorHighPriceImpact' + - $ref: '#/components/schemas/ErrorIntentsDisabled' + '5XX': + description: Server error + content: + application/json: + schema: + oneOf: + - $ref: '#/components/schemas/ErrorWebrpcBadResponse' + - $ref: '#/components/schemas/ErrorWebrpcServerPanic' + - $ref: '#/components/schemas/ErrorWebrpcInternalError' + - $ref: '#/components/schemas/ErrorUnexpected' + - $ref: '#/components/schemas/ErrorChainNodeHealth' + /rpc/Trails/YieldGetMarketById: + post: + operationId: Trails-YieldGetMarketById + tags: ["Trails"] + summary: "YieldGetMarketById returns a Yield market by market ID." + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/GetYieldMarketByIdRequest' + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/GetYieldMarketByIdResponse' + '4XX': + description: Client error + content: + application/json: + schema: + oneOf: + - $ref: '#/components/schemas/ErrorWebrpcEndpoint' + - $ref: '#/components/schemas/ErrorWebrpcRequestFailed' + - $ref: '#/components/schemas/ErrorWebrpcBadRoute' + - $ref: '#/components/schemas/ErrorWebrpcBadMethod' + - $ref: '#/components/schemas/ErrorWebrpcBadRequest' + - $ref: '#/components/schemas/ErrorWebrpcClientAborted' + - $ref: '#/components/schemas/ErrorWebrpcStreamLost' + - $ref: '#/components/schemas/ErrorUnauthorized' + - $ref: '#/components/schemas/ErrorPermissionDenied' + - $ref: '#/components/schemas/ErrorSessionExpired' + - $ref: '#/components/schemas/ErrorMethodNotFound' + - $ref: '#/components/schemas/ErrorRequestConflict' + - $ref: '#/components/schemas/ErrorAborted' + - $ref: '#/components/schemas/ErrorGeoblocked' + - $ref: '#/components/schemas/ErrorRateLimited' + - $ref: '#/components/schemas/ErrorProjectNotFound' + - $ref: '#/components/schemas/ErrorAccessKeyNotFound' + - $ref: '#/components/schemas/ErrorAccessKeyMismatch' + - $ref: '#/components/schemas/ErrorInvalidOrigin' + - $ref: '#/components/schemas/ErrorInvalidService' + - $ref: '#/components/schemas/ErrorUnauthorizedUser' + - $ref: '#/components/schemas/ErrorQuotaExceeded' + - $ref: '#/components/schemas/ErrorQuotaRateLimit' + - $ref: '#/components/schemas/ErrorNoDefaultKey' + - $ref: '#/components/schemas/ErrorMaxAccessKeys' + - $ref: '#/components/schemas/ErrorAtLeastOneKey' + - $ref: '#/components/schemas/ErrorTimeout' + - $ref: '#/components/schemas/ErrorInvalidArgument' + - $ref: '#/components/schemas/ErrorUnavailable' + - $ref: '#/components/schemas/ErrorQueryFailed' + - $ref: '#/components/schemas/ErrorIntentStatus' + - $ref: '#/components/schemas/ErrorNotFound' + - $ref: '#/components/schemas/ErrorUnsupportedNetwork' + - $ref: '#/components/schemas/ErrorClientOutdated' + - $ref: '#/components/schemas/ErrorIntentsSkipped' + - $ref: '#/components/schemas/ErrorQuoteExpired' + - $ref: '#/components/schemas/ErrorHighPriceImpact' + - $ref: '#/components/schemas/ErrorIntentsDisabled' + '5XX': + description: Server error + content: + application/json: + schema: + oneOf: + - $ref: '#/components/schemas/ErrorWebrpcBadResponse' + - $ref: '#/components/schemas/ErrorWebrpcServerPanic' + - $ref: '#/components/schemas/ErrorWebrpcInternalError' + - $ref: '#/components/schemas/ErrorUnexpected' + - $ref: '#/components/schemas/ErrorChainNodeHealth' + /rpc/Trails/YieldCreateEnterAction: + post: + operationId: Trails-YieldCreateEnterAction + tags: ["Trails"] + summary: "YieldCreateEnterAction returns unsigned enter-action transaction payloads." + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CreateYieldActionRequest' + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/CreateYieldActionResponse' + '4XX': + description: Client error + content: + application/json: + schema: + oneOf: + - $ref: '#/components/schemas/ErrorWebrpcEndpoint' + - $ref: '#/components/schemas/ErrorWebrpcRequestFailed' + - $ref: '#/components/schemas/ErrorWebrpcBadRoute' + - $ref: '#/components/schemas/ErrorWebrpcBadMethod' + - $ref: '#/components/schemas/ErrorWebrpcBadRequest' + - $ref: '#/components/schemas/ErrorWebrpcClientAborted' + - $ref: '#/components/schemas/ErrorWebrpcStreamLost' + - $ref: '#/components/schemas/ErrorUnauthorized' + - $ref: '#/components/schemas/ErrorPermissionDenied' + - $ref: '#/components/schemas/ErrorSessionExpired' + - $ref: '#/components/schemas/ErrorMethodNotFound' + - $ref: '#/components/schemas/ErrorRequestConflict' + - $ref: '#/components/schemas/ErrorAborted' + - $ref: '#/components/schemas/ErrorGeoblocked' + - $ref: '#/components/schemas/ErrorRateLimited' + - $ref: '#/components/schemas/ErrorProjectNotFound' + - $ref: '#/components/schemas/ErrorAccessKeyNotFound' + - $ref: '#/components/schemas/ErrorAccessKeyMismatch' + - $ref: '#/components/schemas/ErrorInvalidOrigin' + - $ref: '#/components/schemas/ErrorInvalidService' + - $ref: '#/components/schemas/ErrorUnauthorizedUser' + - $ref: '#/components/schemas/ErrorQuotaExceeded' + - $ref: '#/components/schemas/ErrorQuotaRateLimit' + - $ref: '#/components/schemas/ErrorNoDefaultKey' + - $ref: '#/components/schemas/ErrorMaxAccessKeys' + - $ref: '#/components/schemas/ErrorAtLeastOneKey' + - $ref: '#/components/schemas/ErrorTimeout' + - $ref: '#/components/schemas/ErrorInvalidArgument' + - $ref: '#/components/schemas/ErrorUnavailable' + - $ref: '#/components/schemas/ErrorQueryFailed' + - $ref: '#/components/schemas/ErrorIntentStatus' + - $ref: '#/components/schemas/ErrorNotFound' + - $ref: '#/components/schemas/ErrorUnsupportedNetwork' + - $ref: '#/components/schemas/ErrorClientOutdated' + - $ref: '#/components/schemas/ErrorIntentsSkipped' + - $ref: '#/components/schemas/ErrorQuoteExpired' + - $ref: '#/components/schemas/ErrorHighPriceImpact' + - $ref: '#/components/schemas/ErrorIntentsDisabled' + '5XX': + description: Server error + content: + application/json: + schema: + oneOf: + - $ref: '#/components/schemas/ErrorWebrpcBadResponse' + - $ref: '#/components/schemas/ErrorWebrpcServerPanic' + - $ref: '#/components/schemas/ErrorWebrpcInternalError' + - $ref: '#/components/schemas/ErrorUnexpected' + - $ref: '#/components/schemas/ErrorChainNodeHealth' + /rpc/Trails/YieldCreateExitAction: + post: + operationId: Trails-YieldCreateExitAction + tags: ["Trails"] + summary: "YieldCreateExitAction returns unsigned exit-action transaction payloads." + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CreateYieldActionRequest' + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/CreateYieldActionResponse' + '4XX': + description: Client error + content: + application/json: + schema: + oneOf: + - $ref: '#/components/schemas/ErrorWebrpcEndpoint' + - $ref: '#/components/schemas/ErrorWebrpcRequestFailed' + - $ref: '#/components/schemas/ErrorWebrpcBadRoute' + - $ref: '#/components/schemas/ErrorWebrpcBadMethod' + - $ref: '#/components/schemas/ErrorWebrpcBadRequest' + - $ref: '#/components/schemas/ErrorWebrpcClientAborted' + - $ref: '#/components/schemas/ErrorWebrpcStreamLost' + - $ref: '#/components/schemas/ErrorUnauthorized' + - $ref: '#/components/schemas/ErrorPermissionDenied' + - $ref: '#/components/schemas/ErrorSessionExpired' + - $ref: '#/components/schemas/ErrorMethodNotFound' + - $ref: '#/components/schemas/ErrorRequestConflict' + - $ref: '#/components/schemas/ErrorAborted' + - $ref: '#/components/schemas/ErrorGeoblocked' + - $ref: '#/components/schemas/ErrorRateLimited' + - $ref: '#/components/schemas/ErrorProjectNotFound' + - $ref: '#/components/schemas/ErrorAccessKeyNotFound' + - $ref: '#/components/schemas/ErrorAccessKeyMismatch' + - $ref: '#/components/schemas/ErrorInvalidOrigin' + - $ref: '#/components/schemas/ErrorInvalidService' + - $ref: '#/components/schemas/ErrorUnauthorizedUser' + - $ref: '#/components/schemas/ErrorQuotaExceeded' + - $ref: '#/components/schemas/ErrorQuotaRateLimit' + - $ref: '#/components/schemas/ErrorNoDefaultKey' + - $ref: '#/components/schemas/ErrorMaxAccessKeys' + - $ref: '#/components/schemas/ErrorAtLeastOneKey' + - $ref: '#/components/schemas/ErrorTimeout' + - $ref: '#/components/schemas/ErrorInvalidArgument' + - $ref: '#/components/schemas/ErrorUnavailable' + - $ref: '#/components/schemas/ErrorQueryFailed' + - $ref: '#/components/schemas/ErrorIntentStatus' + - $ref: '#/components/schemas/ErrorNotFound' + - $ref: '#/components/schemas/ErrorUnsupportedNetwork' + - $ref: '#/components/schemas/ErrorClientOutdated' + - $ref: '#/components/schemas/ErrorIntentsSkipped' + - $ref: '#/components/schemas/ErrorQuoteExpired' + - $ref: '#/components/schemas/ErrorHighPriceImpact' + - $ref: '#/components/schemas/ErrorIntentsDisabled' + '5XX': + description: Server error + content: + application/json: + schema: + oneOf: + - $ref: '#/components/schemas/ErrorWebrpcBadResponse' + - $ref: '#/components/schemas/ErrorWebrpcServerPanic' + - $ref: '#/components/schemas/ErrorWebrpcInternalError' + - $ref: '#/components/schemas/ErrorUnexpected' + - $ref: '#/components/schemas/ErrorChainNodeHealth' /rpc/Trails/GetFiatCurrencyList: post: operationId: Trails-GetFiatCurrencyList From 69e767b23f77763ccc063ccedbf6ad87bcbadebf Mon Sep 17 00:00:00 2001 From: ScreamingHawk <1460552+ScreamingHawk@users.noreply.github.com> Date: Mon, 6 Apr 2026 22:18:31 +0000 Subject: [PATCH 13/16] [AUTOMATED] Update: proto/docs/trails-api.gen.yaml --- api-reference/trails-api.gen.yaml | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/api-reference/trails-api.gen.yaml b/api-reference/trails-api.gen.yaml index 2450180..8e29dba 100644 --- a/api-reference/trails-api.gen.yaml +++ b/api-reference/trails-api.gen.yaml @@ -1,4 +1,4 @@ -# trails-api v1 34edef67f3d439e1eca97dc7aa887642e49df57e +# trails-api v1 9d51a97722c875ec619680b1edd5bf3de42402a2 # -- # Code generated by webrpc-gen@v0.36.1 with openapi generator; DO NOT EDIT # @@ -1165,6 +1165,8 @@ components: - ownerAddress - originChainId - destinationChainId + - originTokenAddress + - destinationTokenAddress - originIntentAddress - salt - depositTransaction @@ -1193,6 +1195,10 @@ components: type: number destinationChainId: type: number + originTokenAddress: + type: string + destinationTokenAddress: + type: string originIntentAddress: type: string destinationIntentAddress: @@ -2548,8 +2554,12 @@ components: type: string originChainId: type: number + originTokenAddress: + type: string destinationChainId: type: number + destinationTokenAddress: + type: string fromTime: type: number toTime: From 0a799e7b84b617f484a580068443640f83b01b30 Mon Sep 17 00:00:00 2001 From: pkieltyka <18831+pkieltyka@users.noreply.github.com> Date: Thu, 16 Apr 2026 17:58:20 +0000 Subject: [PATCH 14/16] [AUTOMATED] Update: proto/docs/trails-api.gen.yaml --- api-reference/trails-api.gen.yaml | 407 ++++++++++++++++++++---------- 1 file changed, 272 insertions(+), 135 deletions(-) diff --git a/api-reference/trails-api.gen.yaml b/api-reference/trails-api.gen.yaml index 8e29dba..c4168bf 100644 --- a/api-reference/trails-api.gen.yaml +++ b/api-reference/trails-api.gen.yaml @@ -1,4 +1,4 @@ -# trails-api v1 9d51a97722c875ec619680b1edd5bf3de42402a2 +# trails-api v1 bc043ca0cf316e668f5440ec1f0a0dfc3014a9bd # -- # Code generated by webrpc-gen@v0.36.1 with openapi generator; DO NOT EDIT # @@ -8,10 +8,6 @@ info: title: 'Trails API' version: '' -servers: - - url: https://trails-api.sequence.app - description: Trails API - components: securitySchemes: {'ApiKeyAuth': {'type': 'apiKey', 'in': 'header', 'description': 'Project access key for authenticating requests, get an access key at https://dashboard.trails.build', 'name': 'X-Access-Key'}} schemas: @@ -1981,45 +1977,6 @@ components: type: string currencyType: type: string - RelayTransfer: - type: object - required: - - id - - intentId - - originChainId - - destinationChainId - - originTxnId - - originTxnHash - - destinationTxnId - - destinationTxnHash - - status - - createdAt - - updatedAt - properties: - id: - type: number - intentId: - type: string - originChainId: - type: number - destinationChainId: - type: number - originTxnId: - type: number - originTxnHash: - type: string - destinationTxnId: - type: number - destinationTxnHash: - type: string - status: - type: number - statusReason: - type: string - createdAt: - type: string - updatedAt: - type: string GasFeeOptions: type: object required: @@ -2460,6 +2417,26 @@ components: type: string intentStatus: $ref: '#/components/schemas/IntentStatus' + RetryIntentRequest: + type: object + required: + - intentId + - depositTransactionHash + properties: + intentId: + type: string + depositTransactionHash: + type: string + RetryIntentResponse: + type: object + required: + - intentId + - intentStatus + properties: + intentId: + type: string + intentStatus: + $ref: '#/components/schemas/IntentStatus' GetIntentReceiptRequest: type: object required: @@ -2610,6 +2587,94 @@ components: type: string status: $ref: '#/components/schemas/IntentStatus' + PrepareIntentRecoveryRequest: + type: object + required: + - intentId + properties: + intentId: + type: string + intentAddress: + type: string + refundToAddress: + type: string + tokenAddress: + type: string + PrepareIntentRecoveryResponse: + type: object + required: + - intentId + - intentProtocol + - intentAddress + - chainId + - intentSource + - payload + - typedData + - payloadHash + properties: + intentId: + type: string + intentProtocol: + $ref: '#/components/schemas/IntentProtocolVersion' + intentAddress: + type: string + chainId: + type: number + intentSource: + type: string + recoveryTokens: + type: array + description: '[]IntentTokenBalance' + items: + $ref: '#/components/schemas/IntentTokenBalance' + payload: + type: object + typedData: + type: object + payloadHash: + type: string + BuildIntentRecoveryTransactionRequest: + type: object + required: + - intentId + - payload + - signature + - intentAddress + properties: + intentId: + type: string + payload: + type: object + signature: + type: string + intentAddress: + type: string + refundToAddress: + type: string + BuildIntentRecoveryTransactionResponse: + type: object + required: + - to + - data + - value + - chainId + - intentAddress + - requiresDeploy + properties: + to: + type: string + data: + type: string + value: + type: string + chainId: + type: number + intentAddress: + type: string + requiresDeploy: + type: boolean + payloadHash: + type: string GetTokenPricesRequest: type: object required: @@ -3397,6 +3462,78 @@ paths: - $ref: '#/components/schemas/ErrorWebrpcInternalError' - $ref: '#/components/schemas/ErrorUnexpected' - $ref: '#/components/schemas/ErrorChainNodeHealth' + /rpc/Trails/RetryIntent: + post: + operationId: Trails-RetryIntent + tags: ["Trails"] + summary: "" + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/RetryIntentRequest' + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/RetryIntentResponse' + '4XX': + description: Client error + content: + application/json: + schema: + oneOf: + - $ref: '#/components/schemas/ErrorWebrpcEndpoint' + - $ref: '#/components/schemas/ErrorWebrpcRequestFailed' + - $ref: '#/components/schemas/ErrorWebrpcBadRoute' + - $ref: '#/components/schemas/ErrorWebrpcBadMethod' + - $ref: '#/components/schemas/ErrorWebrpcBadRequest' + - $ref: '#/components/schemas/ErrorWebrpcClientAborted' + - $ref: '#/components/schemas/ErrorWebrpcStreamLost' + - $ref: '#/components/schemas/ErrorUnauthorized' + - $ref: '#/components/schemas/ErrorPermissionDenied' + - $ref: '#/components/schemas/ErrorSessionExpired' + - $ref: '#/components/schemas/ErrorMethodNotFound' + - $ref: '#/components/schemas/ErrorRequestConflict' + - $ref: '#/components/schemas/ErrorAborted' + - $ref: '#/components/schemas/ErrorGeoblocked' + - $ref: '#/components/schemas/ErrorRateLimited' + - $ref: '#/components/schemas/ErrorProjectNotFound' + - $ref: '#/components/schemas/ErrorAccessKeyNotFound' + - $ref: '#/components/schemas/ErrorAccessKeyMismatch' + - $ref: '#/components/schemas/ErrorInvalidOrigin' + - $ref: '#/components/schemas/ErrorInvalidService' + - $ref: '#/components/schemas/ErrorUnauthorizedUser' + - $ref: '#/components/schemas/ErrorQuotaExceeded' + - $ref: '#/components/schemas/ErrorQuotaRateLimit' + - $ref: '#/components/schemas/ErrorNoDefaultKey' + - $ref: '#/components/schemas/ErrorMaxAccessKeys' + - $ref: '#/components/schemas/ErrorAtLeastOneKey' + - $ref: '#/components/schemas/ErrorTimeout' + - $ref: '#/components/schemas/ErrorInvalidArgument' + - $ref: '#/components/schemas/ErrorUnavailable' + - $ref: '#/components/schemas/ErrorQueryFailed' + - $ref: '#/components/schemas/ErrorIntentStatus' + - $ref: '#/components/schemas/ErrorNotFound' + - $ref: '#/components/schemas/ErrorUnsupportedNetwork' + - $ref: '#/components/schemas/ErrorClientOutdated' + - $ref: '#/components/schemas/ErrorIntentsSkipped' + - $ref: '#/components/schemas/ErrorQuoteExpired' + - $ref: '#/components/schemas/ErrorHighPriceImpact' + - $ref: '#/components/schemas/ErrorIntentsDisabled' + '5XX': + description: Server error + content: + application/json: + schema: + oneOf: + - $ref: '#/components/schemas/ErrorWebrpcBadResponse' + - $ref: '#/components/schemas/ErrorWebrpcServerPanic' + - $ref: '#/components/schemas/ErrorWebrpcInternalError' + - $ref: '#/components/schemas/ErrorUnexpected' + - $ref: '#/components/schemas/ErrorChainNodeHealth' /rpc/Trails/WaitIntentReceipt: post: operationId: Trails-WaitIntentReceipt @@ -3829,23 +3966,23 @@ paths: - $ref: '#/components/schemas/ErrorWebrpcInternalError' - $ref: '#/components/schemas/ErrorUnexpected' - $ref: '#/components/schemas/ErrorChainNodeHealth' - /rpc/Trails/GetChains: + /rpc/Trails/PrepareIntentRecovery: post: - operationId: Trails-GetChains + operationId: Trails-PrepareIntentRecovery tags: ["Trails"] - summary: "GetChains will return the list of supported chains by Trails." + summary: "" requestBody: content: application/json: schema: - $ref: '#/components/schemas/GetChainsRequest' + $ref: '#/components/schemas/PrepareIntentRecoveryRequest' responses: '200': description: OK content: application/json: schema: - $ref: '#/components/schemas/GetChainsResponse' + $ref: '#/components/schemas/PrepareIntentRecoveryResponse' '4XX': description: Client error content: @@ -3901,38 +4038,23 @@ paths: - $ref: '#/components/schemas/ErrorWebrpcInternalError' - $ref: '#/components/schemas/ErrorUnexpected' - $ref: '#/components/schemas/ErrorChainNodeHealth' - /rpc/Trails/GetExactOutputRoutes: + /rpc/Trails/BuildIntentRecoveryTransaction: post: - operationId: Trails-GetExactOutputRoutes + operationId: Trails-BuildIntentRecoveryTransaction tags: ["Trails"] - summary: "GetExactOutputRoutes will return a list of origin tokens, when given a destination chain and token," - description: | - that can be used to pay/send from an origin chain the exact output amount on the - destination chain. - - The request will include the destination chain and token desired. Optionally, the - user can specify an origin chain and token to filter results to only that specific - origin token. Additionally, an optional owner address can be provided to filter - results to only tokens the owner has a balance on (requires indexer gateway to be - configured). - - The response is a list of origin tokens and their chains which can be used to fulfill - the exact output request. These are tokens the user can send FROM to achieve the desired - destination token amount. - - aka, the "pay" routes + summary: "" requestBody: content: application/json: schema: - $ref: '#/components/schemas/GetExactOutputRoutesRequest' + $ref: '#/components/schemas/BuildIntentRecoveryTransactionRequest' responses: '200': description: OK content: application/json: schema: - $ref: '#/components/schemas/GetExactOutputRoutesResponse' + $ref: '#/components/schemas/BuildIntentRecoveryTransactionResponse' '4XX': description: Client error content: @@ -3988,33 +4110,23 @@ paths: - $ref: '#/components/schemas/ErrorWebrpcInternalError' - $ref: '#/components/schemas/ErrorUnexpected' - $ref: '#/components/schemas/ErrorChainNodeHealth' - /rpc/Trails/GetExactInputRoutes: + /rpc/Trails/GetChains: post: - operationId: Trails-GetExactInputRoutes + operationId: Trails-GetChains tags: ["Trails"] - summary: "GetExactInputRoutes will return a list of destination tokens, when given an origin chain and token," - description: | - that can be used to send/swap to a destination chain and token. - - The request will include the origin chain and token used for input. Optionally, the - user can specify a destination chain and token to further filter the results. - - The response is a list of destination tokens and their chains which can be reached from - the origin token and chain. These are tokens the user can send TO from the given origin token. - - aka, the "swap" routes + summary: "GetChains will return the list of supported chains by Trails." requestBody: content: application/json: schema: - $ref: '#/components/schemas/GetExactInputRoutesRequest' + $ref: '#/components/schemas/GetChainsRequest' responses: '200': description: OK content: application/json: schema: - $ref: '#/components/schemas/GetExactInputRoutesResponse' + $ref: '#/components/schemas/GetChainsResponse' '4XX': description: Client error content: @@ -4070,25 +4182,38 @@ paths: - $ref: '#/components/schemas/ErrorWebrpcInternalError' - $ref: '#/components/schemas/ErrorUnexpected' - $ref: '#/components/schemas/ErrorChainNodeHealth' - /rpc/Trails/GetTokenList: + /rpc/Trails/GetExactOutputRoutes: post: - operationId: Trails-GetTokenList + operationId: Trails-GetExactOutputRoutes tags: ["Trails"] - summary: "GetTokenList will return a list of tokens based on the provided filters." + summary: "GetExactOutputRoutes will return a list of origin tokens, when given a destination chain and token," description: | - NOTE: there are many filters and options on GetTokenListRequest + that can be used to pay/send from an origin chain the exact output amount on the + destination chain. + + The request will include the destination chain and token desired. Optionally, the + user can specify an origin chain and token to filter results to only that specific + origin token. Additionally, an optional owner address can be provided to filter + results to only tokens the owner has a balance on (requires indexer gateway to be + configured). + + The response is a list of origin tokens and their chains which can be used to fulfill + the exact output request. These are tokens the user can send FROM to achieve the desired + destination token amount. + + aka, the "pay" routes requestBody: content: application/json: schema: - $ref: '#/components/schemas/GetTokenListRequest' + $ref: '#/components/schemas/GetExactOutputRoutesRequest' responses: '200': description: OK content: application/json: schema: - $ref: '#/components/schemas/GetTokenListResponse' + $ref: '#/components/schemas/GetExactOutputRoutesResponse' '4XX': description: Client error content: @@ -4144,23 +4269,33 @@ paths: - $ref: '#/components/schemas/ErrorWebrpcInternalError' - $ref: '#/components/schemas/ErrorUnexpected' - $ref: '#/components/schemas/ErrorChainNodeHealth' - /rpc/Trails/GetTokenPrices: + /rpc/Trails/GetExactInputRoutes: post: - operationId: Trails-GetTokenPrices + operationId: Trails-GetExactInputRoutes tags: ["Trails"] - summary: "GetTokenPrices will return the live prices for a list of tokens." + summary: "GetExactInputRoutes will return a list of destination tokens, when given an origin chain and token," + description: | + that can be used to send/swap to a destination chain and token. + + The request will include the origin chain and token used for input. Optionally, the + user can specify a destination chain and token to further filter the results. + + The response is a list of destination tokens and their chains which can be reached from + the origin token and chain. These are tokens the user can send TO from the given origin token. + + aka, the "swap" routes requestBody: content: application/json: schema: - $ref: '#/components/schemas/GetTokenPricesRequest' + $ref: '#/components/schemas/GetExactInputRoutesRequest' responses: '200': description: OK content: application/json: schema: - $ref: '#/components/schemas/GetTokenPricesResponse' + $ref: '#/components/schemas/GetExactInputRoutesResponse' '4XX': description: Client error content: @@ -4216,23 +4351,25 @@ paths: - $ref: '#/components/schemas/ErrorWebrpcInternalError' - $ref: '#/components/schemas/ErrorUnexpected' - $ref: '#/components/schemas/ErrorChainNodeHealth' - /rpc/Trails/GetExchangeRate: + /rpc/Trails/GetTokenList: post: - operationId: Trails-GetExchangeRate + operationId: Trails-GetTokenList tags: ["Trails"] - summary: "GetExchangeRate returns the exchange rate from USD to a specified currency." + summary: "GetTokenList will return a list of tokens based on the provided filters." + description: | + NOTE: there are many filters and options on GetTokenListRequest requestBody: content: application/json: schema: - $ref: '#/components/schemas/Trails_GetExchangeRate_Request' + $ref: '#/components/schemas/GetTokenListRequest' responses: '200': description: OK content: application/json: schema: - $ref: '#/components/schemas/Trails_GetExchangeRate_Response' + $ref: '#/components/schemas/GetTokenListResponse' '4XX': description: Client error content: @@ -4288,23 +4425,23 @@ paths: - $ref: '#/components/schemas/ErrorWebrpcInternalError' - $ref: '#/components/schemas/ErrorUnexpected' - $ref: '#/components/schemas/ErrorChainNodeHealth' - /rpc/Trails/GetCountryList: + /rpc/Trails/GetTokenPrices: post: - operationId: Trails-GetCountryList + operationId: Trails-GetTokenPrices tags: ["Trails"] - summary: "GetCountryList returns the list of supported countries for onramp providers." + summary: "GetTokenPrices will return the live prices for a list of tokens." requestBody: content: application/json: schema: - $ref: '#/components/schemas/Trails_GetCountryList_Request' + $ref: '#/components/schemas/GetTokenPricesRequest' responses: '200': description: OK content: application/json: schema: - $ref: '#/components/schemas/Trails_GetCountryList_Response' + $ref: '#/components/schemas/GetTokenPricesResponse' '4XX': description: Client error content: @@ -4360,24 +4497,23 @@ paths: - $ref: '#/components/schemas/ErrorWebrpcInternalError' - $ref: '#/components/schemas/ErrorUnexpected' - $ref: '#/components/schemas/ErrorChainNodeHealth' - /rpc/Trails/GetTrailsContracts: + /rpc/Trails/GetExchangeRate: post: - operationId: Trails-GetTrailsContracts + operationId: Trails-GetExchangeRate tags: ["Trails"] - summary: "Deprecated: please use GetProtocolContracts instead" - deprecated: true + summary: "GetExchangeRate returns the exchange rate from USD to a specified currency." requestBody: content: application/json: schema: - $ref: '#/components/schemas/Trails_GetTrailsContracts_Request' + $ref: '#/components/schemas/Trails_GetExchangeRate_Request' responses: '200': description: OK content: application/json: schema: - $ref: '#/components/schemas/Trails_GetTrailsContracts_Response' + $ref: '#/components/schemas/Trails_GetExchangeRate_Response' '4XX': description: Client error content: @@ -4433,23 +4569,23 @@ paths: - $ref: '#/components/schemas/ErrorWebrpcInternalError' - $ref: '#/components/schemas/ErrorUnexpected' - $ref: '#/components/schemas/ErrorChainNodeHealth' - /rpc/Trails/GetProtocolContracts: + /rpc/Trails/GetCountryList: post: - operationId: Trails-GetProtocolContracts + operationId: Trails-GetCountryList tags: ["Trails"] - summary: "GetProtocolContracts returns Trails contract addresses used by the Trails Intents stack for the given protocol." + summary: "GetCountryList returns the list of supported countries for onramp providers." requestBody: content: application/json: schema: - $ref: '#/components/schemas/Trails_GetProtocolContracts_Request' + $ref: '#/components/schemas/Trails_GetCountryList_Request' responses: '200': description: OK content: application/json: schema: - $ref: '#/components/schemas/Trails_GetProtocolContracts_Response' + $ref: '#/components/schemas/Trails_GetCountryList_Response' '4XX': description: Client error content: @@ -4505,23 +4641,24 @@ paths: - $ref: '#/components/schemas/ErrorWebrpcInternalError' - $ref: '#/components/schemas/ErrorUnexpected' - $ref: '#/components/schemas/ErrorChainNodeHealth' - /rpc/Trails/GetSupportedIntentProtocols: + /rpc/Trails/GetTrailsContracts: post: - operationId: Trails-GetSupportedIntentProtocols + operationId: Trails-GetTrailsContracts tags: ["Trails"] - summary: "" + summary: "Deprecated: please use GetProtocolContracts instead" + deprecated: true requestBody: content: application/json: schema: - $ref: '#/components/schemas/Trails_GetSupportedIntentProtocols_Request' + $ref: '#/components/schemas/Trails_GetTrailsContracts_Request' responses: '200': description: OK content: application/json: schema: - $ref: '#/components/schemas/Trails_GetSupportedIntentProtocols_Response' + $ref: '#/components/schemas/Trails_GetTrailsContracts_Response' '4XX': description: Client error content: @@ -4577,23 +4714,23 @@ paths: - $ref: '#/components/schemas/ErrorWebrpcInternalError' - $ref: '#/components/schemas/ErrorUnexpected' - $ref: '#/components/schemas/ErrorChainNodeHealth' - /rpc/Trails/GetDefaultIntentProtocol: + /rpc/Trails/GetProtocolContracts: post: - operationId: Trails-GetDefaultIntentProtocol + operationId: Trails-GetProtocolContracts tags: ["Trails"] - summary: "" + summary: "GetProtocolContracts returns Trails contract addresses used by the Trails Intents stack for the given protocol." requestBody: content: application/json: schema: - $ref: '#/components/schemas/Trails_GetDefaultIntentProtocol_Request' + $ref: '#/components/schemas/Trails_GetProtocolContracts_Request' responses: '200': description: OK content: application/json: schema: - $ref: '#/components/schemas/Trails_GetDefaultIntentProtocol_Response' + $ref: '#/components/schemas/Trails_GetProtocolContracts_Response' '4XX': description: Client error content: @@ -4649,23 +4786,23 @@ paths: - $ref: '#/components/schemas/ErrorWebrpcInternalError' - $ref: '#/components/schemas/ErrorUnexpected' - $ref: '#/components/schemas/ErrorChainNodeHealth' - /rpc/Trails/GetProtocolContracts: + /rpc/Trails/GetSupportedIntentProtocols: post: - operationId: Trails-GetProtocolContracts + operationId: Trails-GetSupportedIntentProtocols tags: ["Trails"] - summary: "GetProtocolContracts returns Trails contract addresses used by the Trails Intents stack for the given protocol." + summary: "" requestBody: content: application/json: schema: - $ref: '#/components/schemas/Trails_GetProtocolContracts_Request' + $ref: '#/components/schemas/Trails_GetSupportedIntentProtocols_Request' responses: '200': description: OK content: application/json: schema: - $ref: '#/components/schemas/Trails_GetProtocolContracts_Response' + $ref: '#/components/schemas/Trails_GetSupportedIntentProtocols_Response' '4XX': description: Client error content: @@ -4721,23 +4858,23 @@ paths: - $ref: '#/components/schemas/ErrorWebrpcInternalError' - $ref: '#/components/schemas/ErrorUnexpected' - $ref: '#/components/schemas/ErrorChainNodeHealth' - /rpc/Trails/GetSupportedIntentProtocols: + /rpc/Trails/GetDefaultIntentProtocol: post: - operationId: Trails-GetSupportedIntentProtocols + operationId: Trails-GetDefaultIntentProtocol tags: ["Trails"] summary: "" requestBody: content: application/json: schema: - $ref: '#/components/schemas/Trails_GetSupportedIntentProtocols_Request' + $ref: '#/components/schemas/Trails_GetDefaultIntentProtocol_Request' responses: '200': description: OK content: application/json: schema: - $ref: '#/components/schemas/Trails_GetSupportedIntentProtocols_Response' + $ref: '#/components/schemas/Trails_GetDefaultIntentProtocol_Response' '4XX': description: Client error content: From 4c93d8bb4f1178c7131ef5fe74fdd822b7f50e9c Mon Sep 17 00:00:00 2001 From: shunkakinoki <39187513+shunkakinoki@users.noreply.github.com> Date: Mon, 20 Apr 2026 11:59:34 +0000 Subject: [PATCH 15/16] [AUTOMATED] Update: proto/docs/trails-api.gen.yaml --- api-reference/trails-api.gen.yaml | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/api-reference/trails-api.gen.yaml b/api-reference/trails-api.gen.yaml index c4168bf..34283ae 100644 --- a/api-reference/trails-api.gen.yaml +++ b/api-reference/trails-api.gen.yaml @@ -1,4 +1,4 @@ -# trails-api v1 bc043ca0cf316e668f5440ec1f0a0dfc3014a9bd +# trails-api v1 46217a84e5718d2c36b2a9de6e1438f8c1c9088f # -- # Code generated by webrpc-gen@v0.36.1 with openapi generator; DO NOT EDIT # @@ -1221,6 +1221,8 @@ components: $ref: '#/components/schemas/IntentProviderQuote' fees: $ref: '#/components/schemas/IntentFees' + gasFeeOptions: + $ref: '#/components/schemas/GasFeeOptions' trailsVersion: type: string intentProtocol: From 47b18ac955ec9f690ceca2b1cd3db8657a6a2c7a Mon Sep 17 00:00:00 2001 From: pkieltyka <18831+pkieltyka@users.noreply.github.com> Date: Mon, 20 Apr 2026 22:52:44 +0000 Subject: [PATCH 16/16] [AUTOMATED] Update: proto/docs/trails-api.gen.yaml --- api-reference/trails-api.gen.yaml | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/api-reference/trails-api.gen.yaml b/api-reference/trails-api.gen.yaml index 34283ae..5864c68 100644 --- a/api-reference/trails-api.gen.yaml +++ b/api-reference/trails-api.gen.yaml @@ -1,4 +1,4 @@ -# trails-api v1 46217a84e5718d2c36b2a9de6e1438f8c1c9088f +# trails-api v1 b255b4d958e14f9ab37e572ff692b09924af2e18 # -- # Code generated by webrpc-gen@v0.36.1 with openapi generator; DO NOT EDIT # @@ -2375,6 +2375,10 @@ components: properties: intent: $ref: '#/components/schemas/Intent' + originConfiguration: + type: object + destinationConfiguration: + type: object gasFeeOptions: $ref: '#/components/schemas/GasFeeOptions' transactionStates: