Step-by-step guide to connecting MetaMask to the Autheo Testnet using a custom RPC network.
Interacting with Autheo’s Testnet requires the use of a compatible cryptocurrency wallet. Autheo uses underlying EVM architecture and is compatible with most major Ethereum-focused wallets.For the purposes of this document, we will be using a browser-based MetaMask Wallet. MetaMask is available through the Chrome store, Google Play store and Apple’s App Store. Always visit the official MetaMask website to download the wallet application, to avoid phishing scams.
Network selection icon outlined in red.Connecting MetaMask to the Autheo Testnet requires the creation of a custom network within your instance of the MetaMask wallet. Clicking on the icon in the upper left of your MetaMask window will bring you to the network selection page.Add a custom network button outlined in red.On the following screen, there is a large + Add a custom network button at the bottom. Click this button to open the custom network details form.On the custom network details screen, you will need to enter the following information:
The RPC URL above is a JSON-RPC endpoint. It accepts POST requests from wallets and applications, not browser GET requests. Visiting it directly in a browser returns 405 Method Not Allowed. This is expected behavior and does not indicate a problem with the network.
After inputting all necessary information, select Save to save the network to your MetaMask wallet. It will now be available from the previously shown network selection screen.
Autheo provides an automated “faucet” that distributes test THEO tokens for user and developer use in learning the platform or testing decentralized applications.You can access the Autheo Testnet faucet.You will need to enter your personal wallet address, which can be obtained at the top of your MetaMask window and will be a long alphanumeric value beginning with 0x (Example: 0x972E44da6d56DFe14073e19DD4183caE7ebA60Ff).You can request 2 THEO up to twice per 24 hour period. If you need additional Testnet THEO tokens, please contact Autheo’s team directly.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Autheo documentation","colors":{"primary":"#007262","light":"#00FED9","dark":"#00A88F"},"logo":{"light":"https://mintcdn.com/autheo/Anmz1CmPS72LUXN4/logo/light.svg?fit=max\u0026auto=format\u0026n=Anmz1CmPS72LUXN4\u0026q=85\u0026s=e1cf2c25fddacc0621c3ca2ddc9c5853","dark":"https://mintcdn.com/autheo/Anmz1CmPS72LUXN4/logo/dark.svg?fit=max\u0026auto=format\u0026n=Anmz1CmPS72LUXN4\u0026q=85\u0026s=5440b5cb830a38a1eabbfb647a288fbe"},"favicon":"https://mintcdn.com/autheo/0JlETvy4cHvGL7cO/favicon.ico?fit=max\u0026auto=format\u0026n=0JlETvy4cHvGL7cO\u0026q=85\u0026s=688b139bf8bf492cbe8f2b2f6dc67b23","navbar":{"links":[{"href":"mailto:info@autheo.com","label":"Support"}],"primary":{"type":"button","label":"autheo.com","href":"https://www.autheo.com/"}},"footer":{"socials":{"x":"https://x.com/Autheo_Network","linkedin":"https://www.linkedin.com/company/autheo/posts?feedView=all","discord":"https://discord.gg/McEEeXGGya","telegram":"https://t.me/autheo/1"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"autheo","hasAudioNarration":false,"actualSubdomain":"autheo","customDomains":["docs.autheo.com"],"gitSource":{"type":"github","owner":"autheo-organization","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ac003bbaa30b8dba727eb84","collectionId":"cfa7e66b-e1df-400b-8cce-ceaca52602b8","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ac003bbaa30b8dba727eb84"},"entitlements":{},"buildId":"6ac003bbaa30b8dba727eb84","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"Node operations","count":38},{"language":"default","tag":"APIs","count":24},{"language":"default","tag":"Nodes","count":23},{"language":"default","tag":"Web Apps","count":18},{"language":"default","tag":"Developers","count":15},{"language":"default","tag":"JSON-RPC","count":12},{"language":"default","tag":"REST","count":11},{"language":"default","tag":"Methods","count":8},{"language":"default","tag":"Getting Started","count":8},{"language":"default","tag":"SDKs","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"editor-v7-file-tree","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"getting-started/wallets/connect-to-testnet","slug":"/getting-started/wallets/connect-to-testnet","pageMetadata":{"title":"Connect To Testnet","description":"Step-by-step guide to connecting MetaMask to the Autheo Testnet using a custom RPC network.","href":"/getting-started/wallets/connect-to-testnet"},"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: \"Step-by-step guide to connecting MetaMask to the Autheo Testnet using a custom RPC network.\"\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`,em:`em`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Note,OptimizedImage}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Interacting with Autheo’s Testnet requires the use of a compatible `,_jsx(_components.a,{href:`https://en.wikipedia.org/wiki/Cryptocurrency_wallet`,children:`cryptocurrency wallet`}),`. Autheo uses underlying EVM architecture and is compatible with most major Ethereum-focused wallets.`]}),`\n`,_jsxs(_components.p,{children:[`For the purposes of this document, we will be using a browser-based `,_jsx(_components.a,{href:`https://metamask.io/`,children:`MetaMask Wallet`}),`. MetaMask is available through the Chrome store, Google Play store and Apple’s App Store. Always visit the official MetaMask website to download the wallet application, to avoid phishing scams.`]}),`\n`,_jsx(Heading,{level:`2`,id:`creating-a-custom-network-in-metamask`,children:`Creating a custom network in MetaMask`}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/autheo/0JlETvy4cHvGL7cO/images/testnet-connect.webp?fit=max\u0026auto=format\u0026n=0JlETvy4cHvGL7cO\u0026q=85\u0026s=7e97204724889e3ef9131c69909575a1`,alt:`Network selection icon outlined in red`,\"data-og-width\":`363`,width:`363`,\"data-og-height\":`610`,height:`610`,\"data-path\":`images/testnet-connect.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/autheo/0JlETvy4cHvGL7cO/images/testnet-connect.webp?w=280\u0026fit=max\u0026auto=format\u0026n=0JlETvy4cHvGL7cO\u0026q=85\u0026s=e327672104381d8111e24b14a2446eda 280w, https://mintcdn.com/autheo/0JlETvy4cHvGL7cO/images/testnet-connect.webp?w=560\u0026fit=max\u0026auto=format\u0026n=0JlETvy4cHvGL7cO\u0026q=85\u0026s=ea98397d1a9c4d7c8077589f5b7839d5 560w, https://mintcdn.com/autheo/0JlETvy4cHvGL7cO/images/testnet-connect.webp?w=840\u0026fit=max\u0026auto=format\u0026n=0JlETvy4cHvGL7cO\u0026q=85\u0026s=34f5a4c07ffeacee4247cbd00194f051 840w, https://mintcdn.com/autheo/0JlETvy4cHvGL7cO/images/testnet-connect.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=0JlETvy4cHvGL7cO\u0026q=85\u0026s=e20f041cdcc0f77641dad8082447c8e5 1100w, https://mintcdn.com/autheo/0JlETvy4cHvGL7cO/images/testnet-connect.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=0JlETvy4cHvGL7cO\u0026q=85\u0026s=4aeda5b950a7c2212101d03ed21462f0 1650w, https://mintcdn.com/autheo/0JlETvy4cHvGL7cO/images/testnet-connect.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=0JlETvy4cHvGL7cO\u0026q=85\u0026s=d86fa12b2dd8bae954062d02ba08bd35 2500w`}),`\n`,_jsx(_components.p,{children:_jsx(_components.em,{children:`Network selection icon outlined in red.`})}),`\n`,_jsx(_components.p,{children:`Connecting MetaMask to the Autheo Testnet requires the creation of a custom network within your instance of the MetaMask wallet. Clicking on the icon in the upper left of your MetaMask window will bring you to the network selection page.`}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/autheo/0JlETvy4cHvGL7cO/images/testnet-add-custom.webp?fit=max\u0026auto=format\u0026n=0JlETvy4cHvGL7cO\u0026q=85\u0026s=f755b7f1e91dbd0cf56a6adb933fe740`,alt:`Add a custom network button outlined in red`,\"data-og-width\":`363`,width:`363`,\"data-og-height\":`610`,height:`610`,\"data-path\":`images/testnet-add-custom.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/autheo/0JlETvy4cHvGL7cO/images/testnet-add-custom.webp?w=280\u0026fit=max\u0026auto=format\u0026n=0JlETvy4cHvGL7cO\u0026q=85\u0026s=ceb3197e0da03e121947a4f220dca5de 280w, https://mintcdn.com/autheo/0JlETvy4cHvGL7cO/images/testnet-add-custom.webp?w=560\u0026fit=max\u0026auto=format\u0026n=0JlETvy4cHvGL7cO\u0026q=85\u0026s=90070f5403e9739da6691d8d127618e4 560w, https://mintcdn.com/autheo/0JlETvy4cHvGL7cO/images/testnet-add-custom.webp?w=840\u0026fit=max\u0026auto=format\u0026n=0JlETvy4cHvGL7cO\u0026q=85\u0026s=ce70922ea54864bba2a66f4fbc7bf5f5 840w, https://mintcdn.com/autheo/0JlETvy4cHvGL7cO/images/testnet-add-custom.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=0JlETvy4cHvGL7cO\u0026q=85\u0026s=f07b702318f85ff5caa461ae7378321f 1100w, https://mintcdn.com/autheo/0JlETvy4cHvGL7cO/images/testnet-add-custom.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=0JlETvy4cHvGL7cO\u0026q=85\u0026s=95ef94af639abb2e047d2c29899f0df6 1650w, https://mintcdn.com/autheo/0JlETvy4cHvGL7cO/images/testnet-add-custom.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=0JlETvy4cHvGL7cO\u0026q=85\u0026s=9b7ef2665ce5065a2e1b3cb9351478da 2500w`}),`\n`,_jsx(_components.p,{children:_jsx(_components.em,{children:`Add a custom network button outlined in red.`})}),`\n`,_jsx(_components.p,{children:`On the following screen, there is a large + Add a custom network button at the bottom. Click this button to open the custom network details form.`}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/autheo/0JlETvy4cHvGL7cO/images/testnet-see-custom.webp?fit=max\u0026auto=format\u0026n=0JlETvy4cHvGL7cO\u0026q=85\u0026s=e50a26904dd6ebeef258069e3c2f65ff`,alt:``,\"data-og-width\":`383`,width:`383`,\"data-og-height\":`589`,height:`589`,\"data-path\":`images/testnet-see-custom.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/autheo/0JlETvy4cHvGL7cO/images/testnet-see-custom.webp?w=280\u0026fit=max\u0026auto=format\u0026n=0JlETvy4cHvGL7cO\u0026q=85\u0026s=a14f03d5d82e6e350c5898a7cbdc8c6a 280w, https://mintcdn.com/autheo/0JlETvy4cHvGL7cO/images/testnet-see-custom.webp?w=560\u0026fit=max\u0026auto=format\u0026n=0JlETvy4cHvGL7cO\u0026q=85\u0026s=fd5acdcdfe15c8c84d198dca2bcbccd8 560w, https://mintcdn.com/autheo/0JlETvy4cHvGL7cO/images/testnet-see-custom.webp?w=840\u0026fit=max\u0026auto=format\u0026n=0JlETvy4cHvGL7cO\u0026q=85\u0026s=8a6a43bd1ba8f69440c9abd1cea17f85 840w, https://mintcdn.com/autheo/0JlETvy4cHvGL7cO/images/testnet-see-custom.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=0JlETvy4cHvGL7cO\u0026q=85\u0026s=b506d9468c893f20779566666a356c18 1100w, https://mintcdn.com/autheo/0JlETvy4cHvGL7cO/images/testnet-see-custom.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=0JlETvy4cHvGL7cO\u0026q=85\u0026s=0e431e931490af4f070ba93304eb5ad0 1650w, https://mintcdn.com/autheo/0JlETvy4cHvGL7cO/images/testnet-see-custom.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=0JlETvy4cHvGL7cO\u0026q=85\u0026s=000b79516093dbb3964d2feff0831b8a 2500w`}),`\n`,_jsx(_components.p,{children:`On the custom network details screen, you will need to enter the following information:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Network name: AUTHEO Testnet`}),`\n`,_jsxs(_components.li,{children:[`Default RPC URL: `,_jsx(_components.code,{children:`https://rpc.testnet.autheo.com`})]}),`\n`,_jsx(_components.li,{children:`Chain ID: 21270`}),`\n`,_jsx(_components.li,{children:`Currency symbol: THEO`}),`\n`,_jsxs(_components.li,{children:[`Block explorer URL: `,_jsx(_components.a,{href:`https://evm-explorer.testnet.autheo.com/`,children:`https://evm-explorer.testnet.autheo.com/`})]}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The RPC URL above is a JSON-RPC endpoint. It accepts `,_jsx(_components.code,{children:`POST`}),` requests from wallets and applications, not browser `,_jsx(_components.code,{children:`GET`}),` requests. Visiting it directly in a browser returns `,_jsx(_components.code,{children:`405 Method Not Allowed`}),`. This is expected behavior and does not indicate a problem with the network.`]})}),`\n`,_jsxs(_components.p,{children:[`After inputting all necessary information, select `,_jsx(_components.strong,{children:`Save`}),` to save the network to your MetaMask wallet. It will now be available from the previously shown network selection screen.`]}),`\n`,_jsx(Heading,{level:`2`,id:`requesting-testnet-theo-tokens`,children:`Requesting Testnet THEO tokens`}),`\n`,_jsx(_components.p,{children:`Autheo provides an automated “faucet” that distributes test THEO tokens for user and developer use in learning the platform or testing decentralized applications.`}),`\n`,_jsxs(_components.p,{children:[`You can access the `,_jsx(_components.a,{href:`https://faucet.testnet.autheo.com/`,children:`Autheo Testnet faucet`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`You will need to enter your personal wallet address, which can be obtained at the top of your MetaMask window and will be a long alphanumeric value beginning with `,_jsx(_components.strong,{children:`0x`}),` (Example: 0x972E44da6d56DFe14073e19DD4183caE7ebA60Ff).`]}),`\n`,_jsx(_components.p,{children:`You can request 2 THEO up to twice per 24 hour period. If you need additional Testnet THEO tokens, please contact Autheo’s team directly.`})]})}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":{"config":{},"pageMetadata":{"title":"Connect To Testnet","description":"Step-by-step guide to connecting MetaMask to the Autheo Testnet using a custom RPC network.","href":"/getting-started/wallets/connect-to-testnet"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Creating a custom network in MetaMask","slug":"creating-a-custom-network-in-metamask","depth":2,"children":[]},{"title":"Requesting Testnet THEO tokens","slug":"requesting-testnet-theo-tokens","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"autheo","siteName":"Autheo documentation","title":"Connect To Testnet - Autheo documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-21T19:02:52.239Z","originalFileLocation":"getting-started/wallets/connect-to-testnet.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=\"Step-by-step guide to connecting MetaMask to the Autheo Testnet using a custom RPC network.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Autheo documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/autheo/B9qtwfZ_VB1YKB9V/_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=\"/mintlify-assets/_mintlify/favicons/autheo/B9qtwfZ_VB1YKB9V/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/autheo/B9qtwfZ_VB1YKB9V/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/autheo/B9qtwfZ_VB1YKB9V/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/autheo/B9qtwfZ_VB1YKB9V/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/autheo/B9qtwfZ_VB1YKB9V/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/autheo/B9qtwfZ_VB1YKB9V/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/autheo/B9qtwfZ_VB1YKB9V/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/autheo/B9qtwfZ_VB1YKB9V/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Connect To Testnet - Autheo documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Step-by-step guide to connecting MetaMask to the Autheo Testnet using a custom RPC network.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Autheo documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.autheo.com/getting-started/wallets/connect-to-testnet\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://autheo.mintlify.app/_mintlify/api/og/v2?division=Wallets\u0026amp;title=Connect+To+Testnet\u0026amp;description=Step-by-step+guide+to+connecting+MetaMask+to+the+Autheo+Testnet+using+a+custom+RPC+network.\u0026amp;theme=c1d489fd408ee7ba99d68b30\u0026amp;signature=ef52307842b3ff000260017d6a847731fcd15fe6bb82534cce000ad16093b934\">\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=\"Connect To Testnet - Autheo documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Step-by-step guide to connecting MetaMask to the Autheo Testnet using a custom RPC network.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://autheo.mintlify.app/_mintlify/api/og/v2?division=Wallets\u0026amp;title=Connect+To+Testnet\u0026amp;description=Step-by-step+guide+to+connecting+MetaMask+to+the+Autheo+Testnet+using+a+custom+RPC+network.\u0026amp;theme=c1d489fd408ee7ba99d68b30\u0026amp;signature=ef52307842b3ff000260017d6a847731fcd15fe6bb82534cce000ad16093b934\">\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=\"/mintlify-assets/_mintlify/favicons/autheo/B9qtwfZ_VB1YKB9V/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Autheo documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#007262\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.autheo.com/getting-started/wallets/connect-to-testnet\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/getting-started/wallets/connect-to-testnet.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.autheo.com/#organization\",\"name\":\"Autheo documentation\",\"url\":\"https://docs.autheo.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/autheo/Anmz1CmPS72LUXN4/logo/light.svg?fit=max\u0026auto=format\u0026n=Anmz1CmPS72LUXN4\u0026q=85\u0026s=e1cf2c25fddacc0621c3ca2ddc9c5853\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.autheo.com#website\",\"name\":\"Autheo documentation\",\"url\":\"https://docs.autheo.com\",\"publisher\":{\"@id\":\"https://docs.autheo.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.autheo.com/getting-started/wallets/connect-to-testnet#webpage\",\"url\":\"https://docs.autheo.com/getting-started/wallets/connect-to-testnet\",\"name\":\"Connect To Testnet\",\"description\":\"Step-by-step guide to connecting MetaMask to the Autheo Testnet using a custom RPC network.\",\"dateModified\":\"2026-09-21T19:02:52.239Z\",\"isPartOf\":{\"@id\":\"https://docs.autheo.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.autheo.com/getting-started/wallets/connect-to-testnet#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.autheo.com/getting-started/wallets/connect-to-testnet#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Getting Started\",\"item\":\"https://docs.autheo.com/getting-started/quickstart\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Wallets\",\"item\":\"https://docs.autheo.com/getting-started/wallets/metamask-install\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Connect To Testnet\",\"item\":\"https://docs.autheo.com/getting-started/wallets/connect-to-testnet\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.autheo.com/getting-started/wallets/connect-to-testnet#article\",\"headline\":\"Connect To Testnet\",\"name\":\"Connect To Testnet\",\"description\":\"Step-by-step guide to connecting MetaMask to the Autheo Testnet using a custom RPC network.\",\"url\":\"https://docs.autheo.com/getting-started/wallets/connect-to-testnet\",\"mainEntityOfPage\":{\"@id\":\"https://docs.autheo.com/getting-started/wallets/connect-to-testnet#webpage\"},\"dateModified\":\"2026-09-21T19:02:52.239Z\",\"publisher\":{\"@id\":\"https://docs.autheo.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.autheo.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Autheo documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Autheo documentation","nav":{"global":null,"groups":[{"group":"Start Here","icon":"play","pages":[{"title":"Autheo OS model","href":"/start-here/autheo-os-model"},{"title":"Choose your path","href":"/start-here/your-path"},{"title":"Architecture at a glance","href":"/start-here/architecture-at-a-glance"},{"title":"Components map","href":"/start-here/components-map"},{"title":"Terminology","href":"/start-here/terminology"},{"title":"Glossary","href":"/start-here/glossary"}]},{"group":"Getting Started","pages":[{"title":"Quickstart","href":"/getting-started/quickstart"},{"group":"Wallets","expanded":false,"pages":[{"title":"MetaMask browser wallet installation","description":null,"href":"/getting-started/wallets/metamask-install"},{"title":"Connect To Testnet","href":"/getting-started/wallets/connect-to-testnet"},{"title":"Autheo account creation","description":null,"href":"/getting-started/wallets/account-basics"}]},{"group":"Network","expanded":false,"pages":[{"title":"Network endpoints","href":"/getting-started/network/endpoints"},{"title":"Testnet faucet","href":"/getting-started/network/faucet"},{"title":"Network troubleshooting","href":"/getting-started/network/troubleshooting"}]},{"title":"FAQ","href":"/getting-started/faq"}]},{"group":"Web Apps","pages":[{"title":"Web apps","href":"/web-apps/overview"},{"group":"Node Sale","expanded":false,"pages":[{"title":"Node Sale Platform","href":"/web-apps/node-sale/overview"},{"title":"Purchasing a license","href":"/web-apps/node-sale/purchasing-a-license"},{"title":"Referral program","href":"/web-apps/node-sale/referral-program"},{"title":"Order history and NFT import","href":"/web-apps/node-sale/order-history"}]},{"group":"Bridge","expanded":false,"pages":[{"title":"Autheo Bridge","href":"/web-apps/bridge/overview"},{"title":"Connecting wallets","href":"/web-apps/bridge/connecting-wallets"},{"title":"Making a transfer","href":"/web-apps/bridge/making-a-transfer"},{"title":"Transfer history","href":"/web-apps/bridge/transfer-history"},{"title":"Bridging THEO from Autheo Mainnet to Base","href":"/web-apps/bridge/bridging-theo-to-base"},{"title":"Bridging THEO from Autheo Mainnet to Robinhood Chain","href":"/web-apps/bridge/bridging-theo-to-robinhood-chain"}]},{"group":"Validator Portal","expanded":false,"pages":[{"title":"Validator Portal","href":"/web-apps/validator-portal/overview"},{"title":"Validator dashboard","href":"/web-apps/validator-portal/dashboard"},{"title":"Deploying a node","href":"/web-apps/validator-portal/deploying-a-node"},{"title":"Delegation","href":"/web-apps/validator-portal/delegation"},{"title":"Rewards and unstaking","href":"/web-apps/validator-portal/rewards-and-unstaking"},{"title":"Activity history","href":"/web-apps/validator-portal/activity-history"},{"title":"Re-add Autheo Mainnet on Keplr","href":"/re-add-autheo-mainnet-on-keplr"}]}]},{"group":"Developers","pages":[{"title":"Developers","href":"/developers/overview"},{"group":"Setup","expanded":false,"pages":[{"title":"Development environment setup","href":"/developers/setup/dev-environment"},{"title":"Autheo CLI installation","href":"/developers/setup/cli-installation"},{"title":"Project scaffolding","href":"/developers/setup/project-scaffolding"}]},{"group":"Tutorials","expanded":false,"pages":[{"title":"Deploying a smart contract on the Autheo blockchain","href":"/developers/tutorials/deploy-smart-contract"},{"title":"Interact with deployed contracts","href":"/developers/tutorials/interact-with-contracts"},{"title":"Events and logs","href":"/developers/tutorials/events-and-logs"},{"title":"Token contracts","href":"/developers/tutorials/token-contracts"},{"title":"Indexing and analytics","href":"/developers/tutorials/indexing-and-analytics"}]},{"group":"Guides","expanded":false,"pages":[{"title":"Key management","href":"/developers/guides/key-management"},{"title":"Security best practices","href":"/developers/guides/security-best-practices"},{"title":"Gas fees and transaction lifecycle","href":"/developers/guides/gas-fees-and-tx-lifecycle"},{"title":"Deployment checklist","href":"/developers/guides/deployment-checklist"}]},{"group":"Troubleshooting","expanded":false,"pages":[{"title":"Common errors","href":"/developers/troubleshooting/common-errors"},{"title":"RPC issues","href":"/developers/troubleshooting/rpc-issues"}]}]},{"group":"APIs","pages":[{"title":"APIs overview","href":"/apis/overview"},{"group":"JSON-RPC","expanded":false,"pages":[{"title":"Overview","href":"/apis/json-rpc/overview"},{"title":"Authentication","href":"/apis/json-rpc/authentication"},{"title":"JSON-RPC error codes","href":"/apis/json-rpc/errors"},{"title":"Rate limits","href":"/apis/json-rpc/rate-limits"},{"group":"Methods","expanded":false,"pages":[{"group":"ETH","expanded":false,"pages":[{"title":"ETH","href":"/apis/json-rpc/methods/eth/eth"},{"title":"Block methods","href":"/apis/json-rpc/methods/eth/eth_block_methods"},{"title":"Gas methods","href":"/apis/json-rpc/methods/eth/eth_gas_methods"},{"title":"Transaction methods","href":"/apis/json-rpc/methods/eth/eth_transaction_methods"},{"title":"Uncle methods","href":"/apis/json-rpc/methods/eth/eth_uncle_methods"},{"title":"Filter methods","href":"/apis/json-rpc/methods/eth/eth_filter_methods"}]},{"group":"net","expanded":false,"pages":[{"title":"Net version","href":"/apis/json-rpc/methods/net/net_version"}]},{"group":"web3","expanded":false,"pages":[{"title":"Web3 client version","href":"/apis/json-rpc/methods/web3/web3_clientVersion"}]}]}]},{"group":"REST","expanded":false,"pages":[{"title":"Overview","href":"/apis/rest/overview"},{"title":"Pagination","href":"/apis/rest/pagination"},{"title":"REST API errors","href":"/apis/rest/errors"},{"group":"Resources","expanded":false,"pages":[{"title":"Main page methods","href":"/apis/rest/resources/main-page-stats"},{"title":"Address methods","href":"/apis/rest/resources/addresses"},{"title":"Block methods","href":"/apis/rest/resources/blocks"},{"title":"Transaction methods","href":"/apis/rest/resources/transactions"},{"title":"Token methods","href":"/apis/rest/resources/tokens"},{"title":"Smart contract methods","href":"/apis/rest/resources/smart-contracts"}]},{"group":"Examples","expanded":false,"pages":[{"title":"cURL examples","href":"/apis/rest/examples/curl"},{"title":"JavaScript examples","href":"/apis/rest/examples/javascript"}]}]}]},{"group":"Node operations","pages":[{"group":"Nodes","expanded":false,"pages":[{"title":"Overview","href":"/nodes/overview"},{"group":"Architecture","expanded":false,"pages":[{"title":"Architecture overview","href":"/nodes/architecture/overview"},{"title":"System architecture","href":"/nodes/architecture/system-architecture"},{"title":"Module overview","href":"/nodes/architecture/module-overview"},{"title":"License gating","href":"/nodes/architecture/license-gating"},{"title":"License lifecycle","href":"/nodes/architecture/license-lifecycle"},{"title":"NFT rewards","href":"/nodes/architecture/nft-rewards"},{"title":"EVM integration","href":"/nodes/architecture/evm-integration"}]},{"group":"Node Setup","pages":[{"title":"Validator setup checklist","href":"/nodes/node-setup/validator-checklist"},{"title":"Prerequisites","href":"/nodes/node-setup/node-setup"},{"title":"Installation","href":"/nodes/node-setup/installation"},{"title":"License setup","href":"/nodes/node-setup/license-setup"},{"title":"Production deployment","href":"/nodes/node-setup/configuration"},{"title":"Node upgrades","href":"/nodes/node-setup/upgrades"},{"title":"Node troubleshooting","href":"/nodes/node-setup/troubleshooting"}]},{"group":"operations","expanded":false,"pages":[{"title":"Monitoring","href":"/nodes/operations/monitoring"},{"title":"Security hardening","href":"/nodes/operations/security-hardening"},{"title":"Backups and restore","href":"/nodes/operations/backups-and-restore"},{"title":"Incident response","href":"/nodes/operations/incident-response"}]},{"group":"Validator Lifecycle","expanded":false,"pages":[{"title":"Register validator","href":"/nodes/validator-lifecycle/register-validator"},{"title":"Consensus key rotation","href":"/nodes/validator-lifecycle/key-rotation"},{"title":"Pause and resume a validator","href":"/nodes/validator-lifecycle/pause-resume"},{"title":"Remove validator node","href":"/nodes/validator-lifecycle/remove-validator"}]}]},{"group":"Validator Program","expanded":false,"pages":[{"title":"Validator program overview","href":"/validator-program/overview"},{"title":"Autheo node sale brochure","href":"/validator-program/brochure"},{"title":"Hosting a validator node","href":"/validator-program/hosting-options"},{"title":"Self-hosting guide","href":"/validator-program/self-hosting-guide"},{"title":"Activation and timeline","href":"/validator-program/activation-and-timeline"},{"title":"Validator economics","href":"/validator-program/economics"},{"title":"Compliance","href":"/validator-program/compliance"}]},{"group":"Token","expanded":false,"pages":[{"title":"THEO token overview","href":"/token/overview"},{"title":"Utility and fees","href":"/token/utility-and-fees"},{"title":"Staking and rewards","href":"/token/staking-and-rewards"},{"title":"Allocations and emissions","href":"/token/allocations-and-emissions"},{"title":"Vesting schedules","href":"/token/vesting"},{"title":"Buying and trading THEO on Hydrex","href":"/token/buying-and-trading-theo"},{"title":"Risks and disclaimers","href":"/token/risks-and-disclaimers"},{"title":"Tokenomics paper v1.3","href":"/token/tokenomics-paper-v1-2"}]}]},{"group":"SDKs","pages":[{"title":"SDKs overview","hidden":true,"href":"/sdks/overview"},{"group":"Go","expanded":false,"pages":[{"title":"Go SDK - Overview","href":"/sdks/go/overview"},{"title":"Install","href":"/sdks/go/install"},{"title":"Quickstart","href":"/sdks/go/quickstart"},{"title":"Methods","href":"/sdks/go/methods"},{"title":"Reference","href":"/sdks/go/reference"},{"group":"Examples","expanded":false,"pages":[{"title":"Contract interaction","href":"/sdks/go/examples/contract-interaction"},{"title":"Query balance","href":"/sdks/go/examples/query-balance"},{"title":"Send transaction","href":"/sdks/go/examples/send-transaction"}]}]}]},{"group":"Papers","pages":[{"title":"Papers and research","href":"/papers/overview"},{"group":"Litepaper","expanded":false,"pages":[{"title":"Litepaper V1.5","href":"/papers/litepaper/v1-5"}]}]}]},"title":"Connect To Testnet - Autheo documentation","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["a74be98ba7"],"chunks":["zoom-image-lightbox-D7yRe3On.js","lightbox-handle-r17bVUz3.js"]}