Skip to main content
POST
GetProtocolContracts returns Trails contract addresses used by the Trails Intents stack for the given protocol.

Overview

GetProtocolContracts returns the deployed Trails contract addresses for a given intent-protocol version. Use it when a client needs the router / entrypoint / router-shim / utils addresses for the version it is about to commit an intent against, instead of hardcoding an address that may drift when a new protocol version rolls out.
This replaces the deprecated GetTrailsContracts endpoint. GetProtocolContracts accepts an explicit intentProtocol parameter, so a single client can serve multiple protocol versions concurrently.

Request Parameters

Response

  • TrailsContracts (object)
    • trailsIntentEntrypointAddress (string)
    • trailsRouterAddress (string)
    • trailsRouterShimAddress (string)
    • trailsUtilsAddress (string)
The response is a single object; addresses are deterministic across chains via the ERC-2470 Singleton Factory.

Example

Next Steps

GetSupportedIntentProtocols

List every supported intent-protocol version

GetDefaultIntentProtocol

Discover the API’s current default version

Body

application/json
intentProtocol
enum<string>

Represented as string on the server side

Available options:
v1,
v1_5

Response

OK

TrailsContracts
object