Choose production trust parameters, permissions, signing, and service configuration for IBC Solidity and IBC CLI.
The tutorial uses development-friendly keys, permissions, and configuration. Do not copy it into production unchanged.
Configure light-client security
Attestor set and threshold
An n-attestor set with threshold t tolerates n - t unavailable attestors; forging state requires t compromised keys. There is no universal production threshold. Choose n and t by stating how many unavailable and compromised keys the deployment must tolerate. For example, 2-of-3 tolerates one unavailable or compromised key, while 3-of-5 tolerates two. These are example profiles, not protocol requirements.The attestor set and minRequiredSigs are fixed in the on-chain client. Verify both on chain before enabling relaying.
Quorum: Never use a one-of-one attestor set in production. One unavailable attestor stops the connection, and one compromised key can forge state.
Key reuse: Never reuse an attestor key across clients or chains because signatures are not bound to a chain, router, or verifying client.
Besu clients
For a QBFT or IBFT 2.0 counterparty, see Besu light clients for the parameter mechanics and update rules. In production:
Keep the default trustLevel of 2/3 unless the deployment’s threat model explicitly selects a lower value.
Choose trustingPeriod from the counterparty’s validator governance and key-retirement policy. It must be long enough that packet activity advances the client before expiry, but no longer than historical validators remain trustworthy.
Set contract permissions deliberately
ibc deploy core makes relaying public. In production, prefer permissioned relaying: grant RELAYER_ROLE to the relayer account for IBCMulticall.multicall and to IBCMulticall for the router’s relay functions before replacing PUBLIC_ROLE. Use permissionless relaying only as an explicit policy choice. See Grant, change, and revoke a role.At minimum, transfer ADMIN_ROLE and each IFT’s authority from the deployer to a multisig. Best practice is a timelocked governance executor controlled by a multisig or on-chain governance, with an on-chain delay for upgrades, role changes, client migrations, and IFT configuration. OpenZeppelin’s TimelockController is one implementation.
Configure IFT rate limits
Configure and verify a rate limit independently on every IFT deployment. Choose its capacity and window from the maximum loss or issuance acceptable before governance can intervene, not merely from expected throughput. Account for token decimals and traffic across every registered bridge.See IFT rate limits for contract behavior and ibc deploy ift for configuration flags.
Configure signing and services
Signing
Use a dedicated key for every role and trust boundary: one administration key, one deployment key, one relayer account per chain, and one key per attestor. Never reuse keys across roles, chains, services, or hosts.In production, use Cosmos KMS as the remote signer for relayer and attestor keys. Protect the administration role with multisig approval where supported. Treat the deployment key as temporary: fund it only for deployment, then revoke its privileges and remove it.
Attestors
Never run attestors in-process with the relayer in production. Run each attestor as a standalone process with a unique signer, and configure it as a remote attestor in the relayer.
An attestor trusts its configured chain RPC for state correctness. Use an endpoint whose operator and data you trust; changing that endpoint changes the attestor’s trust assumptions.Each local attestor selects its highest attestable height:
finalityOffset: 0 uses the RPC endpoint’s finalized block.
A positive value uses latest - finalityOffset without proving that block final.
Besu QBFT and IBFT 2.0 chains do not support finalityOffset: 0. Use finalityOffset: 1; their committed blocks have immediate finality, so a larger offset only delays attestations. Omitting the field selects zero.Use the same finalityOffset for every attestor in the quorum.
Relayers
For each client end, verify the chain ID, client ID, light-client type, signer, and autoRelay setting. Use a separate funded signer for each destination chain.A relayer trusts each configured chain RPC for operational chain data and transaction submission. Use endpoints whose operators and data you trust; changing an endpoint changes the relayer’s trust assumptions.The light client prevents a relayer RPC from forging packet state, but the RPC still controls the relayer’s view of heads, receipts, nonces, gas, and fees.A relayer database must have only one active relayer process. Multiple active relayers sharing a database are not supported.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"IBC Documentation","description":"Documentation for the Inter-Blockchain Communication protocol, its Go implementation, and the IBC CLI.","colors":{"primary":"#000000","light":"#cccccc","dark":"#0E0E0E"},"logo":{"light":"https://mintcdn.com/ibc-docs/_IzGrVOELf0DsHtq/mintlify/assets/brand/ibc-wordmark-dark.svg?fit=max\u0026auto=format\u0026n=_IzGrVOELf0DsHtq\u0026q=85\u0026s=dd69509f8e278637cefba78620bc6f19","dark":"https://mintcdn.com/ibc-docs/_IzGrVOELf0DsHtq/mintlify/assets/brand/ibc-wordmark.svg?fit=max\u0026auto=format\u0026n=_IzGrVOELf0DsHtq\u0026q=85\u0026s=4332fd7d24e0e9834a0ff6d9b0907db8","href":"/"},"favicon":{"light":"https://mintcdn.com/ibc-docs/_IzGrVOELf0DsHtq/mintlify/assets/brand/ibc-dark.svg?fit=max\u0026auto=format\u0026n=_IzGrVOELf0DsHtq\u0026q=85\u0026s=950310224e31e8dcbbbae521db80542e","dark":"https://mintcdn.com/ibc-docs/_IzGrVOELf0DsHtq/mintlify/assets/brand/ibc.svg?fit=max\u0026auto=format\u0026n=_IzGrVOELf0DsHtq\u0026q=85\u0026s=8846e23ba7502345c1b7016d0ec9315d"},"navbar":{"primary":{"type":"button","label":"Get started","href":"/ibc/05-ibc-cli/02-tutorial/01-deploy-ibc-and-send-a-token"}},"footer":{"socials":{"x":"https://twitter.com/cosmos","github":"https://github.com/lfdt-ibc","discord":"https://discord.gg/interchain","website":"https://cosmos.network"},"links":[{"header":"Documentation","items":[{"label":"Learn how IBC works","href":"/docs/ibc/01-introduction/01-what-is-ibc"},{"label":"IBC CLI","href":"/docs/ibc/05-ibc-cli/01-overview"},{"label":"IBC-Solidity","href":"/docs/ibc/06-ibc-solidity-contracts/01-overview"},{"label":"IBC-Go","href":"/docs/ibc-go/latest/intro"},{"label":"Specification","href":"/docs/ibc/spec/ics-001-ics-standard/README"}]},{"header":"Repositories","items":[{"label":"lfdt-ibc/ibc","href":"https://github.com/lfdt-ibc/ibc"},{"label":"lfdt-ibc/ibc-go","href":"https://github.com/lfdt-ibc/ibc-go"},{"label":"lfdt-ibc/ibc-contracts","href":"https://github.com/lfdt-ibc/ibc-contracts"}]},{"header":"Security","items":[{"label":"Security audits","href":"/docs/ibc/07-security/01-audits"},{"label":"Bug Bounty","href":"https://immunefi.com/bug-bounty/cosmos/information"}]}]},"icons":{"library":"lucide"},"styling":{"codeblocks":{"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}},"latex":false},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ibc-docs","hasAudioNarration":false,"actualSubdomain":"ibc-docs","customDomains":[],"gitSource":{"type":"github","owner":"lfdt-ibc","repo":"ibc","deployBranch":"main","contentDirectory":"docs","isPrivate":false,"mountPath":"","label":"","_id":"6ae38e8fd265945f8832a739"},"feedback":{"edits":true,"thumbs":true},"entitlements":{},"buildId":"6afddf75c21646c008d93d97","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"IBC-Go","count":124},{"language":"default","tag":"Specification","count":42},{"language":"default","tag":"IBC Light Clients","count":30},{"language":"default","tag":"IBC Apps","count":23},{"language":"default","tag":"IBC Core","count":21},{"language":"default","tag":"IBC Migrations","count":17},{"language":"default","tag":"Architecture Decision Records","count":16},{"language":"default","tag":"Applications","count":16},{"language":"default","tag":"IBC Middleware","count":14},{"language":"default","tag":"Version Upgrades","count":14}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"mintlify/style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'Fira Code';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/firacode/v27/uU9NCBsR6Z2vfE9aq3bh0NSDulI.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Fira Code';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/firacode/v27/uU9NCBsR6Z2vfE9aq3bh2dSDulI.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek-ext */\n@font-face {\n font-family: 'Fira Code';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/firacode/v27/uU9NCBsR6Z2vfE9aq3bh0dSDulI.woff2) format('woff2');\n unicode-range: U+1F00-1FFF;\n}\n/* greek */\n@font-face {\n font-family: 'Fira Code';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/firacode/v27/uU9NCBsR6Z2vfE9aq3bh3tSDulI.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* symbols2 */\n@font-face {\n font-family: 'Fira Code';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/firacode/v27/uU9NCBsR6Z2vfE9aq3bhZ_Wmh2uX.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Fira Code';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/firacode/v27/uU9NCBsR6Z2vfE9aq3bh09SDulI.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Fira Code';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/firacode/v27/uU9NCBsR6Z2vfE9aq3bh3dSD.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'Fira Code';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/firacode/v27/uU9NCBsR6Z2vfE9aq3bh0NSDulI.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Fira Code';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/firacode/v27/uU9NCBsR6Z2vfE9aq3bh2dSDulI.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek-ext */\n@font-face {\n font-family: 'Fira Code';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/firacode/v27/uU9NCBsR6Z2vfE9aq3bh0dSDulI.woff2) format('woff2');\n unicode-range: U+1F00-1FFF;\n}\n/* greek */\n@font-face {\n font-family: 'Fira Code';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/firacode/v27/uU9NCBsR6Z2vfE9aq3bh3tSDulI.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* symbols2 */\n@font-face {\n font-family: 'Fira Code';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/firacode/v27/uU9NCBsR6Z2vfE9aq3bhZ_Wmh2uX.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Fira Code';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/firacode/v27/uU9NCBsR6Z2vfE9aq3bh09SDulI.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Fira Code';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/firacode/v27/uU9NCBsR6Z2vfE9aq3bh3dSD.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--background-light: 255 255 255}#navigation-items .bg-primary\\/10,#navigation-items .dark\\:bg-primary-light\\/10:is(.dark *){background-color:var(--nav-accent, #40b3ff)}#navigation-items .bg-primary\\/10.text-primary,#navigation-items .bg-primary\\/10 .text-primary,#navigation-items .dark\\:bg-primary-light\\/10:is(.dark *),#navigation-items .dark\\:bg-primary-light\\/10:is(.dark *) .text-primary{color:var(--nav-accent-ink, #0e0e0e)}@font-face{font-family:'The Future';src:url('/mintlify/assets/fonts/the-future-regular.woff2') format('woff2');font-weight:400;font-style:normal;font-display:swap}@font-face{font-family:'The Future';src:url('/mintlify/assets/fonts/the-future-medium.woff2') format('woff2');font-weight:500;font-style:normal;font-display:swap}@font-face{font-family:'The Future';src:url('/mintlify/assets/fonts/the-future-bold.woff2') format('woff2');font-weight:700;font-style:normal;font-display:swap}@font-face{font-family:'The Future';src:url('/mintlify/assets/fonts/the-future-light.woff2') format('woff2');font-weight:300;font-style:normal;font-display:swap}body:has(#custom-index-content) header,body:has(#custom-index-content) #navbar,body:has(#custom-index-content) #header,body:has(#custom-index-content) nav[aria-label],body:has(#custom-index-content) button#search-bar-entry,body:has(#custom-index-content) button#search-bar-entry-mobile,body:has(#custom-index-content) #search-bar-entry,body:has(#custom-index-content) #search-bar-entry-mobile,body:has(#custom-index-content) .chat-assistant-floating-input,body:has(#custom-index-content) *:has(>.chat-assistant-floating-input){display:none!important;visibility:hidden!important;opacity:0!important;width:0!important;height:0!important;position:absolute!important;left:-99999px!important;pointer-events:none!important}body:has(#custom-index-content) #custom-index-content{font-family:'The Future', sans-serif}body:has(#custom-index-content) #custom-index-content h1,body:has(#custom-index-content) #custom-index-content h2,body:has(#custom-index-content) #custom-index-content h3,body:has(#custom-index-content) #custom-index-content p,body:has(#custom-index-content) #custom-index-content a{font-family:'The Future', sans-serif}@media (max-width: 768px){button[aria-label=\"More actions\"]{display:none!important}#custom-index-content{margin-top:-120px}}@media (min-width: 769px) and (max-width: 1023px){#custom-index-content{margin-top:-120px}}.prose p a,.prose li a,.prose ul a,.prose span a,.prose div[data-callout-type] a,.prose .callout a,.prose .info a,.prose .note a,.prose .warning a,.prose .tip a,.prose .steps a,.prose .step a,.prose [role=\"listitem\"] a{border-bottom-color:#0E0E0E!important;text-decoration-color:#0E0E0E!important}.dark .prose p a,.dark .prose li a,.dark .prose ul a,.dark .prose span a,.dark .prose div[data-callout-type] a,.dark .prose .callout a,.dark .prose .info a,.dark .prose .note a,.dark .prose .warning a,.dark .prose .tip a,.dark .prose .steps a,.dark .prose .step a,.dark .prose [role=\"listitem\"] a{border-bottom-color:#cccccc!important;text-decoration-color:#cccccc!important}.highlighted-card-bg{background-color:#FFB84D;position:relative;overflow:hidden;transition:box-shadow 0.3s ease-in-out}.highlighted-card-bg:hover{box-shadow:0 0 30px rgba(255, 184, 77, 0.5),\n 0 0 60px rgba(255, 184, 77, 0.3),\n 0 10px 40px rgba(255, 184, 77, 0.2)}.highlighted-card-bg::before{content:'';position:absolute;top:-50%;left:-50%;width:200%;height:200%;background:linear-gradient(\n 45deg,\n transparent 30%,\n rgba(255, 255, 255, 0.4) 50%,\n transparent 70%\n );transform:translateX(-100%) translateY(-100%) rotate(45deg);transition:transform 0.6s ease-in-out}.highlighted-card-bg:hover::before{transform:translateX(100%) translateY(100%) rotate(45deg)}@layer utilities{body:has(#custom-index-content) #footer{display:flex!important}}pre,pre code,code{font-family:'Fira Code', 'Cascadia Code', 'JetBrains Mono', monospace!important}header a>span.absolute.bg-primary-dark,#navbar a>span.absolute.bg-primary-dark{background-color:var(--nav-accent, #40b3ff);transition:background-color 120ms ease}header a:hover>span.absolute.bg-primary-dark,#navbar a:hover>span.absolute.bg-primary-dark{background-color:color-mix(in srgb, var(--nav-accent, #40b3ff) 82%, white);opacity:1}header a:has(>span.absolute.bg-primary-dark),header a:has(>span.absolute.bg-primary-dark) *,#navbar a:has(>span.absolute.bg-primary-dark),#navbar a:has(>span.absolute.bg-primary-dark) *{color:var(--nav-accent-ink, #0e0e0e);font-weight:600}.nav-tabs-item{--tab-accent: #40b3ff;--tab-ink: #0e0e0e;transition:color 120ms ease}.nav-tabs-item::before{content:\"\";position:absolute;inset:9px -10px;border-radius:0.5rem;background-color:transparent;transition:background-color 120ms ease;z-index:-1}.nav-tabs-item:hover::before,.nav-tabs-item:focus-visible::before{background-color:var(--tab-accent)}.nav-tabs-item:hover,.nav-tabs-item:hover *,.nav-tabs-item:focus-visible,.nav-tabs-item:focus-visible *{color:var(--tab-ink)!important}.nav-tabs-item[href*=\"/ibc/05-ibc-cli/\"]:not([href^=\"http\"]){--tab-accent: #22e2a8;--tab-ink: #0e0e0e}.nav-tabs-item[href*=\"/ibc/06-ibc-solidity-contracts/\"]:not([href^=\"http\"]){--tab-accent: #7522b5;--tab-ink: #ffffff}.nav-tabs-item[href*=\"/ibc-go/\"]:not([href^=\"http\"]){--tab-accent: #4b47ca;--tab-ink: #ffffff}.nav-tabs-item[href*=\"/ibc/spec/\"]:not([href^=\"http\"]){--tab-accent: #ef5628;--tab-ink: #0e0e0e}.nav-tabs-item .bg-primary{background-color:color-mix(in srgb, var(--tab-accent, #40b3ff) 65%, black)}.nav-tabs-item .dark\\:bg-primary-light:is(.dark *){background-color:color-mix(in srgb, var(--tab-accent, #40b3ff) 80%, white)}img.nav-logo{height:3rem}"}],"page":{"pagePath":"ibc/05-ibc-cli/03-guides/02a-plan-a-production-deployment","slug":"/ibc/05-ibc-cli/03-guides/02a-plan-a-production-deployment","pageMetadata":{"title":"Plan a production deployment","description":"Choose production trust parameters, permissions, signing, and service configuration for IBC Solidity and IBC CLI.","href":"/ibc/05-ibc-cli/03-guides/02a-plan-a-production-deployment"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Choose production trust parameters, permissions, signing, and service configuration for IBC Solidity and IBC CLI.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`The tutorial uses development-friendly keys, permissions, and configuration. Do not copy it into production unchanged.`}),`\n`,_jsx(Heading,{level:`2`,id:`configure-light-client-security`,children:`Configure light-client security`}),`\n`,_jsx(Heading,{level:`3`,id:`attestor-set-and-threshold`,children:`Attestor set and threshold`}),`\n`,_jsxs(_components.p,{children:[`An `,_jsx(_components.code,{children:`n`}),`-attestor set with threshold `,_jsx(_components.code,{children:`t`}),` tolerates `,_jsx(_components.code,{children:`n - t`}),` unavailable attestors; forging state requires `,_jsx(_components.code,{children:`t`}),` compromised keys. There is no universal production threshold. Choose `,_jsx(_components.code,{children:`n`}),` and `,_jsx(_components.code,{children:`t`}),` by stating how many unavailable and compromised keys the deployment must tolerate. For example, 2-of-3 tolerates one unavailable or compromised key, while 3-of-5 tolerates two. These are example profiles, not protocol requirements.`]}),`\n`,_jsxs(_components.p,{children:[`The attestor set and `,_jsx(_components.code,{children:`minRequiredSigs`}),` are fixed in the on-chain client. Verify both on chain before enabling relaying.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Quorum:`}),` Never use a one-of-one attestor set in production. One unavailable attestor stops the connection, and one compromised key can forge state.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Key reuse:`}),` Never reuse an attestor key across clients or chains because signatures are not bound to a chain, router, or verifying client.`]}),`\n`]})}),`\n`,_jsx(Heading,{level:`3`,id:`besu-clients`,children:`Besu clients`}),`\n`,_jsxs(_components.p,{children:[`For a QBFT or IBFT 2.0 counterparty, see `,_jsx(_components.a,{href:`/ibc/04-light-clients/03-besu-light-client`,children:`Besu light clients`}),` for the parameter mechanics and update rules. In production:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Keep the default `,_jsx(_components.code,{children:`trustLevel`}),` of `,_jsx(_components.code,{children:`2/3`}),` unless the deployment’s threat model explicitly selects a lower value.`]}),`\n`,_jsxs(_components.li,{children:[`Choose `,_jsx(_components.code,{children:`trustingPeriod`}),` from the counterparty’s validator governance and key-retirement policy. It must be long enough that packet activity advances the client before expiry, but no longer than historical validators remain trustworthy.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`set-contract-permissions-deliberately`,children:`Set contract permissions deliberately`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`ibc deploy core`}),` makes relaying public. In production, prefer permissioned relaying: grant `,_jsx(_components.code,{children:`RELAYER_ROLE`}),` to the relayer account for `,_jsx(_components.code,{children:`IBCMulticall.multicall`}),` and to `,_jsx(_components.code,{children:`IBCMulticall`}),` for the router’s relay functions before replacing `,_jsx(_components.code,{children:`PUBLIC_ROLE`}),`. Use permissionless relaying only as an explicit policy choice. See `,_jsx(_components.a,{href:`/ibc/05-ibc-cli/03-guides/05-grant-change-and-revoke-a-role`,children:`Grant, change, and revoke a role`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`At minimum, transfer `,_jsx(_components.code,{children:`ADMIN_ROLE`}),` and each IFT’s authority from the deployer to a multisig. Best practice is a timelocked governance executor controlled by a multisig or on-chain governance, with an on-chain delay for upgrades, role changes, client migrations, and IFT configuration. OpenZeppelin’s `,_jsx(_components.a,{href:`https://docs.openzeppelin.com/contracts/5.x/api/governance#TimelockController`,children:_jsx(_components.code,{children:`TimelockController`})}),` is one implementation.`]}),`\n`,_jsx(Heading,{level:`2`,id:`configure-ift-rate-limits`,children:`Configure IFT rate limits`}),`\n`,_jsx(_components.p,{children:`Configure and verify a rate limit independently on every IFT deployment. Choose its capacity and window from the maximum loss or issuance acceptable before governance can intervene, not merely from expected throughput. Account for token decimals and traffic across every registered bridge.`}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/ibc/06-ibc-solidity-contracts/04-ift-contracts#rate-limits`,children:`IFT rate limits`}),` for contract behavior and `,_jsx(_components.a,{href:`/ibc/05-ibc-cli/04-reference/02-cli-commands#ibc-deploy-ift`,children:_jsx(_components.code,{children:`ibc deploy ift`})}),` for configuration flags.`]}),`\n`,_jsx(Heading,{level:`2`,id:`configure-signing-and-services`,children:`Configure signing and services`}),`\n`,_jsx(Heading,{level:`3`,id:`signing`,children:`Signing`}),`\n`,_jsx(_components.p,{children:`Use a dedicated key for every role and trust boundary: one administration key, one deployment key, one relayer account per chain, and one key per attestor. Never reuse keys across roles, chains, services, or hosts.`}),`\n`,_jsxs(_components.p,{children:[`In production, use `,_jsx(_components.a,{href:`https://github.com/cosmos/kms`,children:`Cosmos KMS`}),` as the remote signer for relayer and attestor keys. Protect the administration role with multisig approval where supported. Treat the deployment key as temporary: fund it only for deployment, then revoke its privileges and remove it.`]}),`\n`,_jsx(Heading,{level:`3`,id:`attestors`,children:`Attestors`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Never run attestors in-process with the relayer in production. Run each attestor as a standalone process with a unique signer, and configure it as a remote attestor in the relayer.`})}),`\n`,_jsx(_components.p,{children:`An attestor trusts its configured chain RPC for state correctness. Use an endpoint whose operator and data you trust; changing that endpoint changes the attestor’s trust assumptions.`}),`\n`,_jsx(_components.p,{children:`Each local attestor selects its highest attestable height:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`finalityOffset: 0`}),` uses the RPC endpoint’s `,_jsx(_components.code,{children:`finalized`}),` block.`]}),`\n`,_jsxs(_components.li,{children:[`A positive value uses `,_jsx(_components.code,{children:`latest - finalityOffset`}),` without proving that block final.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Besu QBFT and IBFT 2.0 chains do not support `,_jsx(_components.code,{children:`finalityOffset: 0`}),`. Use `,_jsx(_components.code,{children:`finalityOffset: 1`}),`; their committed blocks have immediate finality, so a larger offset only delays attestations. Omitting the field selects zero.`]}),`\n`,_jsxs(_components.p,{children:[`Use the same `,_jsx(_components.code,{children:`finalityOffset`}),` for every attestor in the quorum.`]}),`\n`,_jsx(Heading,{level:`3`,id:`relayers`,children:`Relayers`}),`\n`,_jsxs(_components.p,{children:[`For each client end, verify the chain ID, client ID, light-client type, signer, and `,_jsx(_components.code,{children:`autoRelay`}),` setting. Use a separate funded signer for each destination chain.`]}),`\n`,_jsx(_components.p,{children:`A relayer trusts each configured chain RPC for operational chain data and transaction submission. Use endpoints whose operators and data you trust; changing an endpoint changes the relayer’s trust assumptions.`}),`\n`,_jsx(_components.p,{children:`The light client prevents a relayer RPC from forging packet state, but the RPC still controls the relayer’s view of heads, receipts, nonces, gas, and fees.`}),`\n`,_jsx(_components.p,{children:`A relayer database must have only one active relayer process. Multiple active relayers sharing a database are not supported.`}),`\n`,_jsx(Heading,{level:`2`,id:`related-guides`,children:`Related guides`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/ibc/05-ibc-cli/03-guides/01-run-a-standalone-attestor`,children:`Run a standalone attestor`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/ibc/05-ibc-cli/03-guides/02-run-a-standalone-relayer`,children:`Run a standalone relayer`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/ibc/05-ibc-cli/04-reference/01-configuration`,children:`Configuration reference`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/ibc/06-ibc-solidity-contracts/06-permissions-and-upgrades`,children:`Permissions and upgrades`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/ibc/05-ibc-cli/03-guides/06-rotate-an-attestor-set`,children:`Rotate an attestor set`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/ibc/05-ibc-cli/04-reference/04-observability-and-metrics`,children:`Observability and metrics`})}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}},"config":{},"pageMetadata":{"title":"Plan a production deployment","description":"Choose production trust parameters, permissions, signing, and service configuration for IBC Solidity and IBC CLI.","href":"/ibc/05-ibc-cli/03-guides/02a-plan-a-production-deployment"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Configure light-client security","slug":"configure-light-client-security","depth":2,"children":[{"title":"Attestor set and threshold","slug":"attestor-set-and-threshold","depth":3,"children":[]},{"title":"Besu clients","slug":"besu-clients","depth":3,"children":[]}]},{"title":"Set contract permissions deliberately","slug":"set-contract-permissions-deliberately","depth":2,"children":[]},{"title":"Configure IFT rate limits","slug":"configure-ift-rate-limits","depth":2,"children":[]},{"title":"Configure signing and services","slug":"configure-signing-and-services","depth":2,"children":[{"title":"Signing","slug":"signing","depth":3,"children":[]},{"title":"Attestors","slug":"attestors","depth":3,"children":[]},{"title":"Relayers","slug":"relayers","depth":3,"children":[]}]},{"title":"Related guides","slug":"related-guides","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/ibc-docs/39ce1023281414fe/custom.js"],"subdomain":"ibc-docs","siteName":"IBC Documentation","title":"Plan a production deployment - IBC Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-03T12:25:09.488Z","originalFileLocation":"ibc/05-ibc-cli/03-guides/02a-plan-a-production-deployment.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Choose production trust parameters, permissions, signing, and service configuration for IBC Solidity and IBC CLI.\">\u003cmeta data-mint-head name=\"application-name\" content=\"IBC Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/ibc-docs/M8QbcV1CzT5u-Qmv/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/ibc-docs/M8QbcV1CzT5u-Qmv/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/ibc-docs/M8QbcV1CzT5u-Qmv/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/ibc-docs/M8QbcV1CzT5u-Qmv/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/ibc-docs/M8QbcV1CzT5u-Qmv/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/ibc-docs/M8QbcV1CzT5u-Qmv/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/ibc-docs/M8QbcV1CzT5u-Qmv/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/ibc-docs/M8QbcV1CzT5u-Qmv/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/ibc-docs/M8QbcV1CzT5u-Qmv/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Plan a production deployment - IBC Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Choose production trust parameters, permissions, signing, and service configuration for IBC Solidity and IBC CLI.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"IBC Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://ibc-docs.mintlify.dev/docs/ibc/05-ibc-cli/03-guides/02a-plan-a-production-deployment\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ibc-docs.mintlify.site/docs/_mintlify/api/og/v2?division=Run+the+services\u0026amp;title=Plan+a+production+deployment\u0026amp;description=Choose+production+trust+parameters%2C+permissions%2C+signing%2C+and+service+configuration+for+IBC+Solidity+and+IBC+CLI.\u0026amp;theme=7b813d6f72aa6f1ed1f74535\u0026amp;signature=12cb69c86914ef46149290840acdfb3d37c2a3371a29f3eff0d208cf72a361ac\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Plan a production deployment - IBC Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Choose production trust parameters, permissions, signing, and service configuration for IBC Solidity and IBC CLI.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ibc-docs.mintlify.site/docs/_mintlify/api/og/v2?division=Run+the+services\u0026amp;title=Plan+a+production+deployment\u0026amp;description=Choose+production+trust+parameters%2C+permissions%2C+signing%2C+and+service+configuration+for+IBC+Solidity+and+IBC+CLI.\u0026amp;theme=7b813d6f72aa6f1ed1f74535\u0026amp;signature=12cb69c86914ef46149290840acdfb3d37c2a3371a29f3eff0d208cf72a361ac\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/ibc-docs/M8QbcV1CzT5u-Qmv/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"IBC Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://ibc-docs.mintlify.dev/docs/ibc/05-ibc-cli/03-guides/02a-plan-a-production-deployment\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/ibc/05-ibc-cli/03-guides/02a-plan-a-production-deployment.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://ibc-docs.mintlify.dev/#organization\",\"name\":\"IBC Documentation\",\"url\":\"https://ibc-docs.mintlify.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ibc-docs/_IzGrVOELf0DsHtq/mintlify/assets/brand/ibc-wordmark-dark.svg?fit=max\u0026auto=format\u0026n=_IzGrVOELf0DsHtq\u0026q=85\u0026s=dd69509f8e278637cefba78620bc6f19\"}},{\"@type\":\"WebSite\",\"@id\":\"https://ibc-docs.mintlify.dev/docs#website\",\"name\":\"IBC Documentation\",\"url\":\"https://ibc-docs.mintlify.dev/docs\",\"publisher\":{\"@id\":\"https://ibc-docs.mintlify.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://ibc-docs.mintlify.dev/docs/ibc/05-ibc-cli/03-guides/02a-plan-a-production-deployment#webpage\",\"url\":\"https://ibc-docs.mintlify.dev/docs/ibc/05-ibc-cli/03-guides/02a-plan-a-production-deployment\",\"name\":\"Plan a production deployment\",\"description\":\"Choose production trust parameters, permissions, signing, and service configuration for IBC Solidity and IBC CLI.\",\"dateModified\":\"2026-11-03T12:25:09.488Z\",\"isPartOf\":{\"@id\":\"https://ibc-docs.mintlify.dev/docs#website\"},\"breadcrumb\":{\"@id\":\"https://ibc-docs.mintlify.dev/docs/ibc/05-ibc-cli/03-guides/02a-plan-a-production-deployment#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://ibc-docs.mintlify.dev/docs/ibc/05-ibc-cli/03-guides/02a-plan-a-production-deployment#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Run the services\",\"item\":\"https://ibc-docs.mintlify.dev/docs/ibc/05-ibc-cli/03-guides/01-run-a-standalone-attestor\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Plan a production deployment\",\"item\":\"https://ibc-docs.mintlify.dev/docs/ibc/05-ibc-cli/03-guides/02a-plan-a-production-deployment\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://ibc-docs.mintlify.dev/docs/ibc/05-ibc-cli/03-guides/02a-plan-a-production-deployment#article\",\"headline\":\"Plan a production deployment\",\"name\":\"Plan a production deployment\",\"description\":\"Choose production trust parameters, permissions, signing, and service configuration for IBC Solidity and IBC CLI.\",\"url\":\"https://ibc-docs.mintlify.dev/docs/ibc/05-ibc-cli/03-guides/02a-plan-a-production-deployment\",\"mainEntityOfPage\":{\"@id\":\"https://ibc-docs.mintlify.dev/docs/ibc/05-ibc-cli/03-guides/02a-plan-a-production-deployment#webpage\"},\"dateModified\":\"2026-11-03T12:25:09.488Z\",\"publisher\":{\"@id\":\"https://ibc-docs.mintlify.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://ibc-docs.mintlify.dev/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"IBC Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"IBC Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/ibc/05-ibc-cli/03-guides/02a-plan-a-production-deployment.md","siteName":"IBC Documentation","nav":{"global":null,"tabs":[{"tab":"Learn","pages":[{"title":"Learn","href":""}]},{"tab":"IBC CLI","groups":[{"group":"About","icon":"info","pages":[{"title":"IBC CLI overview","href":"/ibc/05-ibc-cli/01-overview"}]},{"group":"Tutorial","icon":"graduation-cap","pages":[{"title":"Deploy IBC and send a token","href":"/ibc/05-ibc-cli/02-tutorial/01-deploy-ibc-and-send-a-token"}]},{"group":"Run the services","icon":"server","pages":[{"title":"Run a standalone attestor","href":"/ibc/05-ibc-cli/03-guides/01-run-a-standalone-attestor"},{"title":"Run a standalone relayer","description":"Run a relayer in its own process, querying attestors it does not host.","href":"/ibc/05-ibc-cli/03-guides/02-run-a-standalone-relayer"},{"title":"Plan a production deployment","href":"/ibc/05-ibc-cli/03-guides/02a-plan-a-production-deployment"}]},{"group":"Guides","icon":"compass","pages":[{"title":"Make a cross-chain GMP call","description":"Call a contract on another chain over IBC, and receive the result back as an acknowledgement.","href":"/ibc/05-ibc-cli/03-guides/03-make-a-cross-chain-gmp-call"},{"title":"Upgrade an IBC contract","href":"/ibc/05-ibc-cli/03-guides/04-upgrade-the-router-contract"},{"title":"Grant, change, and revoke a role","href":"/ibc/05-ibc-cli/03-guides/05-grant-change-and-revoke-a-role"},{"title":"Rotate an attestor set","href":"/ibc/05-ibc-cli/03-guides/06-rotate-an-attestor-set"}]},{"group":"Reference","icon":"book","pages":[{"title":"Configuration","href":"/ibc/05-ibc-cli/04-reference/01-configuration"},{"title":"CLI commands","href":"/ibc/05-ibc-cli/04-reference/02-cli-commands"},{"title":"API","href":"/ibc/05-ibc-cli/04-reference/03-api"},{"title":"Observability and metrics","href":"/ibc/05-ibc-cli/04-reference/04-observability-and-metrics"}]},{"group":"Repositories","icon":"folder-git-2","pages":[{"title":"lfdt-ibc/ibc","url":"https://github.com/lfdt-ibc/ibc","icon":"github","href":"/ibc/repos/cli-ibc"}]}]},{"tab":"IBC-Solidity","pages":[{"title":"IBC-Solidity","href":"/ibc/06-ibc-solidity-contracts/01-overview"}]},{"tab":"IBC-Go","versions":[{"version":"latest","groups":[{"group":"Introduction","icon":"book-open","pages":[{"title":"IBC Documentation","href":"/ibc-go/latest/intro"}]},{"group":"IBC Core","icon":"box","pages":[{"title":"Overview","href":"/ibc-go/latest/ibc/overview"},{"group":"Core Concepts","icon":"lightbulb","pages":[{"title":"Best Practices","href":"/ibc-go/latest/ibc/best-practices"},{"title":"Integration","href":"/ibc-go/latest/ibc/integration"},{"title":"Permissioning","href":"/ibc-go/latest/ibc/permissioning"},{"title":"Relayer","href":"/ibc-go/latest/ibc/relayer"}]},{"group":"Apps","icon":"app-window","pages":[{"title":"IBC v2 Applications","href":"/ibc-go/latest/ibc/apps/ibcv2apps"},{"title":"IBC Applications","href":"/ibc-go/latest/ibc/apps/apps"},{"title":"Implement IBCModule interface and callbacks","href":"/ibc-go/latest/ibc/apps/ibcmodule"},{"title":"Bind ports","href":"/ibc-go/latest/ibc/apps/bindports"},{"title":"Keeper","href":"/ibc-go/latest/ibc/apps/keeper"},{"title":"Define packets and acks","href":"/ibc-go/latest/ibc/apps/packets_acks"},{"title":"Routing","href":"/ibc-go/latest/ibc/apps/routing"},{"title":"Custom Address Codec","href":"/ibc-go/latest/ibc/apps/address-codec"}]},{"group":"Middleware","icon":"layers","pages":[{"title":"IBC middleware","href":"/ibc-go/latest/ibc/middleware/overview"},{"title":"Create a custom IBC middleware","href":"/ibc-go/latest/ibc/middleware/develop"},{"title":"Create and integrate IBC v2 middleware","href":"/ibc-go/latest/ibc/middleware/developIBCv2"},{"title":"Integrating IBC middleware into a chain","href":"/ibc-go/latest/ibc/middleware/integration"}]},{"group":"Upgrades","icon":"arrow-up","pages":[{"title":"Upgrading IBC Chains Overview","href":"/ibc-go/latest/ibc/upgrades/intro"},{"title":"How to Upgrade IBC Chains and their Clients","href":"/ibc-go/latest/ibc/upgrades/quick-guide"},{"title":"IBC Client Developer Guide to Upgrades","href":"/ibc-go/latest/ibc/upgrades/developer-guide"},{"title":"Genesis Restart Upgrades","href":"/ibc-go/latest/ibc/upgrades/genesis-restart"}]}]},{"group":"IBC Migrations","icon":"arrow-right-left","pages":[{"group":"Version Upgrades","icon":"git-branch","pages":[{"title":"IBC-Go v11.0 to v11.1","href":"/ibc-go/latest/migrations/v11-to-v11-1"},{"title":"IBC-Go v10 to v11.1","href":"/ibc-go/latest/migrations/v10-to-v11-1"},{"title":"IBC-Go v10 to v11","href":"/ibc-go/latest/migrations/v10-to-v11"},{"title":"IBC-Go v8.1 to v10","href":"/ibc-go/latest/migrations/v8_1-to-v10"},{"title":"IBC-Go v8 to v8.1","href":"/ibc-go/latest/migrations/v8-to-v8_1"},{"title":"IBC-Go v7 to v8","href":"/ibc-go/latest/migrations/v7-to-v8"},{"title":"IBC-Go v7.2 to v7.3","href":"/ibc-go/latest/migrations/v7_2-to-v7_3"},{"title":"IBC-Go v7 to v7.1","href":"/ibc-go/latest/migrations/v7-to-v7_1"},{"title":"IBC-Go v6 to v7","href":"/ibc-go/latest/migrations/v6-to-v7"},{"title":"IBC-Go v5 to v6","href":"/ibc-go/latest/migrations/v5-to-v6"},{"title":"IBC-Go v4 to v5","href":"/ibc-go/latest/migrations/v4-to-v5"},{"title":"IBC-Go v3 to v4","href":"/ibc-go/latest/migrations/v3-to-v4"},{"title":"IBC-Go v2 to v3","href":"/ibc-go/latest/migrations/v2-to-v3"},{"title":"IBC-Go v1 to v2","href":"/ibc-go/latest/migrations/v1-to-v2"}]},{"group":"Additional Migration Guides","icon":"map","pages":[{"title":"SDK v0.43 to IBC-Go v1","href":"/ibc-go/latest/migrations/sdk-to-v1"},{"title":"Support transfer of coins whose base denom contains slashes","href":"/ibc-go/latest/migrations/support-denoms-with-slashes"},{"title":"Support the new StackBuilder primitive for Wiring Middlewares in the chain application","href":"/ibc-go/latest/migrations/support-stackbuilder"}]}]},{"group":"IBC Light Clients","icon":"shield-check","pages":[{"group":"Developer Guide","icon":"code","pages":[{"title":"Overview","href":"/ibc-go/latest/light-clients/developer-guide/overview"},{"title":"Light Client Module interface","href":"/ibc-go/latest/light-clients/developer-guide/light-client-module"},{"title":"Client State interface","href":"/ibc-go/latest/light-clients/developer-guide/client-state"},{"title":"Consensus State interface","href":"/ibc-go/latest/light-clients/developer-guide/consensus-state"},{"title":"Handling Updates and Misbehaviour","href":"/ibc-go/latest/light-clients/developer-guide/updates-and-misbehaviour"},{"title":"Handling Upgrades","href":"/ibc-go/latest/light-clients/developer-guide/upgrades"},{"title":"Existence/Non-Existence Proofs","href":"/ibc-go/latest/light-clients/developer-guide/proofs"},{"title":"Handling Proposals","href":"/ibc-go/latest/light-clients/developer-guide/proposals"},{"title":"Setup","href":"/ibc-go/latest/light-clients/developer-guide/setup"},{"title":"Governance Proposals","href":"/ibc-go/latest/light-clients/proposals"}]},{"group":"Attestation","icon":"badge-check","pages":[{"title":"The attestation light client","href":"/ibc-go/latest/light-clients/attestation/attestation-light-client"}]},{"group":"Localhost","icon":"monitor","pages":[{"title":"Overview","href":"/ibc-go/latest/light-clients/localhost/overview"},{"title":"Integration","href":"/ibc-go/latest/light-clients/localhost/integration"},{"title":"ClientState","href":"/ibc-go/latest/light-clients/localhost/client-state"},{"title":"Connection","href":"/ibc-go/latest/light-clients/localhost/connection"},{"title":"State Verification","href":"/ibc-go/latest/light-clients/localhost/state-verification"}]},{"group":"Solo Machine","icon":"cpu","pages":[{"title":"Solomachine","href":"/ibc-go/latest/light-clients/solomachine/solomachine"},{"title":"Concepts","href":"/ibc-go/latest/light-clients/solomachine/concepts"},{"title":"State","href":"/ibc-go/latest/light-clients/solomachine/state"},{"title":"State Transitions","href":"/ibc-go/latest/light-clients/solomachine/state_transitions"}]},{"group":"Tendermint","icon":"boxes","pages":[{"title":"Overview","href":"/ibc-go/latest/light-clients/tendermint/overview"}]},{"group":"WASM","icon":"binary","pages":[{"title":"Overview","href":"/ibc-go/latest/light-clients/wasm/overview"},{"title":"Concepts","href":"/ibc-go/latest/light-clients/wasm/concepts"},{"title":"Integration","href":"/ibc-go/latest/light-clients/wasm/integration"},{"title":"Messages","href":"/ibc-go/latest/light-clients/wasm/messages"},{"title":"Governance","href":"/ibc-go/latest/light-clients/wasm/governance"},{"title":"Events","href":"/ibc-go/latest/light-clients/wasm/events"},{"title":"Contracts","href":"/ibc-go/latest/light-clients/wasm/contracts"},{"title":"Client","href":"/ibc-go/latest/light-clients/wasm/client"},{"title":"Migrations","href":"/ibc-go/latest/light-clients/wasm/migrations"}]}]},{"group":"IBC Apps","icon":"blocks","pages":[{"title":"General Message Passing (GMP)","href":"/ibc-go/latest/apps/gmp"},{"group":"Interchain Accounts","icon":"users","pages":[{"title":"Overview","href":"/ibc-go/latest/apps/interchain-accounts/overview"},{"title":"Development Use Cases","href":"/ibc-go/latest/apps/interchain-accounts/development"},{"title":"Authentication Modules","href":"/ibc-go/latest/apps/interchain-accounts/auth-modules"},{"title":"Integration","href":"/ibc-go/latest/apps/interchain-accounts/integration"},{"title":"Messages","href":"/ibc-go/latest/apps/interchain-accounts/messages"},{"title":"Parameters","href":"/ibc-go/latest/apps/interchain-accounts/parameters"},{"title":"Transaction Encoding","href":"/ibc-go/latest/apps/interchain-accounts/tx-encoding"},{"title":"Client","href":"/ibc-go/latest/apps/interchain-accounts/client"},{"title":"Active Channels","href":"/ibc-go/latest/apps/interchain-accounts/active-channels"},{"group":"Legacy","icon":"archive","pages":[{"title":"Authentication Modules","href":"/ibc-go/latest/apps/interchain-accounts/legacy/auth-modules"},{"title":"Integration","href":"/ibc-go/latest/apps/interchain-accounts/legacy/integration"},{"title":"Keeper API","href":"/ibc-go/latest/apps/interchain-accounts/legacy/keeper-api"}]}]},{"group":"Transfer","icon":"send","pages":[{"title":"Overview","href":"/ibc-go/latest/apps/transfer/overview"},{"title":"State","href":"/ibc-go/latest/apps/transfer/state"},{"title":"State Transitions","href":"/ibc-go/latest/apps/transfer/state-transitions"},{"title":"Messages","href":"/ibc-go/latest/apps/transfer/messages"},{"title":"Events","href":"/ibc-go/latest/apps/transfer/events"},{"title":"Metrics","href":"/ibc-go/latest/apps/transfer/metrics"},{"title":"Params","href":"/ibc-go/latest/apps/transfer/params"},{"title":"Authorizations","href":"/ibc-go/latest/apps/transfer/authorizations"},{"title":"Client","href":"/ibc-go/latest/apps/transfer/client"},{"title":"IBC v2 Transfer","href":"/ibc-go/latest/apps/transfer/IBCv2-transfer"}]}]},{"group":"IBC Middleware","icon":"layers","pages":[{"group":"Callbacks","icon":"repeat","pages":[{"title":"Overview","href":"/ibc-go/latest/middleware/callbacks/overview"},{"title":"Integration","href":"/ibc-go/latest/middleware/callbacks/integration"},{"title":"Interfaces","href":"/ibc-go/latest/middleware/callbacks/interfaces"},{"title":"Events","href":"/ibc-go/latest/middleware/callbacks/events"},{"title":"End Users","href":"/ibc-go/latest/middleware/callbacks/end-users"},{"title":"Gas Management","href":"/ibc-go/latest/middleware/callbacks/gas"},{"title":"Callbacks with IBC v2","href":"/ibc-go/latest/middleware/callbacks/callbacks-IBCv2"}]},{"group":"Packet Forward Middleware","icon":"forward","pages":[{"title":"Overview","href":"/ibc-go/latest/middleware/packet-forward-middleware/overview"},{"title":"Integration","href":"/ibc-go/latest/middleware/packet-forward-middleware/integration"},{"title":"Example Flows","href":"/ibc-go/latest/middleware/packet-forward-middleware/example-usage"}]},{"group":"Rate Limit Middleware","icon":"gauge","pages":[{"title":"Overview","href":"/ibc-go/latest/middleware/rate-limit-middleware/overview"},{"title":"Integration","href":"/ibc-go/latest/middleware/rate-limit-middleware/integration"},{"title":"Setting Rate Limits","href":"/ibc-go/latest/middleware/rate-limit-middleware/setting-limits"},{"title":"Migration","href":"/ibc-go/latest/middleware/rate-limit-middleware/migration"}]}]},{"group":"Security","icon":"lock","pages":[{"title":"Security Audits","href":"/ibc-go/latest/security-audits"}]},{"group":"Architecture Decision Records","icon":"scroll-text","pages":[{"title":"Architecture Decision Records (ADR)","href":"/ibc-go/latest/architecture/README"},{"title":"ADR 001: Coin Source Tracing","href":"/ibc-go/latest/architecture/adr-001-coin-source-tracing"},{"title":"ADR 002: Go Module Versioning","href":"/ibc-go/latest/architecture/adr-002-go-module-versioning"},{"title":"ADR 003: ICS-27 Acknowledgement Format","href":"/ibc-go/latest/architecture/adr-003-ics27-acknowledgement"},{"title":"ADR 004: Lock Fee Module Upon Escrow Out Of Balance","href":"/ibc-go/latest/architecture/adr-004-ics29-lock-fee-module"},{"title":"ADR 005: UpdateClient Events ClientState Consensus Heights","href":"/ibc-go/latest/architecture/adr-005-consensus-height-events"},{"title":"ADR 006: 02-Client Refactor","href":"/ibc-go/latest/architecture/adr-006-02-client-refactor"},{"title":"ADR 007: Solo Machine Sign Bytes","href":"/ibc-go/latest/architecture/adr-007-solomachine-signbytes"},{"title":"ADR 008: Callback to IBC Actors","href":"/ibc-go/latest/architecture/adr-008-app-caller-cbs"},{"title":"ADR 009: ICS27 Message Server Addition","href":"/ibc-go/latest/architecture/adr-009-v6-ics27-msgserver"},{"title":"ADR 010: IBC Light Clients As SDK Modules","href":"/ibc-go/latest/architecture/adr-010-light-clients-as-sdk-modules"},{"title":"ADR 011: ICS-20 Transfer State Entry For Total Amount Of Tokens In Escrow","href":"/ibc-go/latest/architecture/adr-011-transfer-total-escrow-state-entry"},{"title":"ADR 015: IBC Packet Receiver","href":"/ibc-go/latest/architecture/adr-015-ibc-packet-receiver"},{"title":"ADR 025: IBC Passive Channels","href":"/ibc-go/latest/architecture/adr-025-ibc-passive-channels"},{"title":"ADR 026: IBC Client Recovery Mechanisms","href":"/ibc-go/latest/architecture/adr-026-ibc-client-recovery-mechanisms"},{"title":"ADR 27: Add Support For Wasm Based Light Client","href":"/ibc-go/latest/architecture/adr-027-ibc-wasm"}]},{"group":"Changelog","icon":"rotate-ccw","pages":[{"title":"Changelog","mode":"wide","href":"/ibc-go/latest/changelog/release-notes"}]},{"group":"Repositories","icon":"folder-git-2","pages":[{"title":"lfdt-ibc/ibc-go","url":"https://github.com/lfdt-ibc/ibc-go","icon":"github","href":"/ibc-go/latest/repos/go-ibc-go"}]}]},{"version":"v10.1.x","pages":[{"title":"v10.1.x","href":"/ibc-go/v10.1.x/intro"}]}]},{"tab":"Specification","pages":[{"title":"Specification","href":"/ibc/spec/ics-001-ics-standard/README"}]}]},"basePath":"","title":"Plan a production deployment - IBC Documentation","deploymentId":"dpl_J2QdBVuN65x4CCtpqPb371YPt4xi","buildId":"dpl_J2QdBVuN65x4CCtpqPb371YPt4xi","dynamics":[],"chunks":[]}