This section introduces the core concepts and wallet models used across the OpenXSwitch Wallet Infrastructure.
OpenXSwitch’s Wallet Infrastructure provides programmable wallet infrastructure for developers, fintechs, institutions, exchanges, wallet providers, and trading platforms building on EVM, Solana, Bitcoin, and other supported chains.The infrastructure is designed to abstract blockchain complexity while enabling modern financial experiences and programmable transaction flows.
OpenXSwitch Wallet Infrastructure supports two types of wallet models designed for programmable operations, liquidity management, and user segregation:
Smart Wallets (Account Abstraction): Programmable on-chain smart contract wallets that support gasless transactions, transaction sponsorship, batch execution, and advanced policy-based permissions.
Wallets: Standard blockchain addresses provisioned under an account structure for multi-chain asset routing and custody.
A single wallet address can be used to receive supported assets across multiple EVM chains and tokens. To learn more, see Unified Wallet Addressing on EVM Chains.
Accounts serve as administrative and logical containers for grouping wallets, users, and operational rules. Key capabilities include:
Withdrawal Execution: Execute external crypto withdrawals via both the OpenXSwitch API and the operational Dashboard.
Global Account Control (Disable/Enable): Disabling or enabling an Account immediately applies to all wallets attached to that account.
Disabling an Account: Temporarily suspends operations and freezes outbound actions for all underlying wallets under that account.
Enabling an Account: Restores operational status and API access to all wallets grouped within the account structure.
Watchlist Configuration: Configure watchlist monitoring directly at the Account level to track and screen specific blockchain addresses for risk management.
Note: User entities are attached directly to specific wallets (rather than to Accounts). This enables identity mapping, user-level access management, and customer wallet orchestration directly at the individual wallet level.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"OpenXSwitch | Docs","description":"OpenXSwitch is building an infrastructure that abstracts wallets, gas, liquidity, and blockchain complexity into programmable financial primitives that developers and businesses can integrate globally.\nOpenXSwitch is the most affordable, and robust platform to work with digital assets \u0026 stablecoins across Africa.","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/openxswitch/ML35RDblT1Ol-zJb/images/LightBlog(1).png?fit=max\u0026auto=format\u0026n=ML35RDblT1Ol-zJb\u0026q=85\u0026s=062e79ad9c4540929eec204aff020178","dark":"https://mintcdn.com/openxswitch/ML35RDblT1Ol-zJb/images/DarkBlog(1).png?fit=max\u0026auto=format\u0026n=ML35RDblT1Ol-zJb\u0026q=85\u0026s=f6328956931c9664a2a070c2edb6e9b3","href":"/"},"favicon":{"light":"https://mintcdn.com/openxswitch/ML35RDblT1Ol-zJb/images/LinkedinX.png?fit=max\u0026auto=format\u0026n=ML35RDblT1Ol-zJb\u0026q=85\u0026s=a03db0ff0a3f9f5f6696217533a86549","dark":"https://mintcdn.com/openxswitch/ML35RDblT1Ol-zJb/images/LinkedinX.png?fit=max\u0026auto=format\u0026n=ML35RDblT1Ol-zJb\u0026q=85\u0026s=a03db0ff0a3f9f5f6696217533a86549"},"appearance":{"default":"system"},"navbar":{"links":[{"href":"mailto:support@openxswitch.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://console.openxswitch.com"}},"footer":{"socials":{"x":"https://x.com/OpenXSwitch","linkedin":"https://linkedin.com/company/OpenXSwitch"}},"seo":{"metatags":{"title":"OpenXSwitch Docs","keyword":"OpenXSwitch, Wallet as a service, Smart Account, Crypto as a service, Wallet infrastructure, Sablecoin Orchestration, Stablecoin Infrastructure"},"indexing":"all"},"styling":{"eyebrows":"section","latex":false},"contextual":{"options":["chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"interaction":{"drilldown":false},"markdown":{"schema":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"openxswitch","hasAudioNarration":false,"actualSubdomain":"openxswitch","customDomains":["docs.openxswitch.com"],"gitSource":{"type":"github","owner":"openxswitch","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a6a39bea324037a170b10a9","collectionId":"1c69da45-5ed2-4f0b-acad-f152cd5cd92c","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a6a39bea324037a170b10a9"},"entitlements":{},"buildId":"6ae0684f9df8262685aef794","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"Wallet as a Service - API Reference - v1","count":70},{"language":"default","tag":"API Reference","count":41},{"language":"default","tag":"Wallet as a Service","count":34},{"language":"default","tag":"Introduction","count":24},{"language":"default","tag":"Sandbox","count":20},{"language":"default","tag":"Transactions","count":20},{"language":"default","tag":"Sub Wallet Endpoints","count":17},{"language":"default","tag":"Swaps","count":14},{"language":"default","tag":"Users","count":14},{"language":"default","tag":"Wallet Management","count":13}]},"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}],"privacy":{"consentBanner":{"enabled":true}},"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"wallet-infrastructure/architecture","slug":"/wallet-infrastructure/architecture","pageMetadata":{"title":"Wallet Infrastructure: Architecture","description":"This section introduces the core concepts and wallet models used across the OpenXSwitch Wallet Infrastructure.","sidebarTitle":"Architecture","href":"/wallet-infrastructure/architecture"},"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: \"This section introduces the core concepts and wallet models used across the OpenXSwitch Wallet Infrastructure.\"\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`,blockquote:`blockquote`,code:`code`,em:`em`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Table,Tip}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`OpenXSwitch’s Wallet Infrastructure provides programmable wallet infrastructure for developers, fintechs, institutions, exchanges, wallet providers, and trading platforms building on EVM, Solana, Bitcoin, and other supported chains.`}),`\n`,_jsx(_components.p,{children:`The infrastructure is designed to abstract blockchain complexity while enabling modern financial experiences and programmable transaction flows.`}),`\n`,_jsx(Heading,{level:`2`,id:`architecture-overview`,children:`Architecture Overview`}),`\n`,_jsx(_components.p,{children:`OpenXSwitch Wallet Infrastructure supports core concepts designed for programmable wallet operations, treasury routing, settlement flows, and end-user wallet management:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.strong,{children:`Model`})}),_jsx(_components.th,{children:_jsx(_components.strong,{children:`Description`})}),_jsx(_components.th,{children:_jsx(_components.strong,{children:`Best For`})})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Accounts`})}),_jsxs(_components.td,{children:[`Logical `,_jsx(_components.strong,{children:`container`}),` used to `,_jsx(_components.strong,{children:`group`}),` and manage wallets.`]}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Treasury`}),` separation, application-level grouping, operational `,_jsx(_components.strong,{children:`isolation`}),`, and user segmentation.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Users`})}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`End-user`}),` entities associated with accounts or specific wallet permissions.`]}),_jsxs(_components.td,{children:[`Identity mapping, `,_jsx(_components.strong,{children:`user-level`}),` access management, and customer wallet orchestration.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Wallets`})}),_jsxs(_components.td,{children:[`Actual blockchain `,_jsx(_components.strong,{children:`wallet`}),` `,_jsx(_components.strong,{children:`addresses`}),` grouped and managed under an account structure.`]}),_jsx(_components.td,{children:`Deposits, programmable transfers, gasless transactions, and wallet execution flows.`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Wallets`}),` can be directly attached to a user entity for identity mapping and user-level access.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`types-of-accounts`,children:`Types of Accounts`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Account Type`})}),_jsx(_components.th,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Description`})}),_jsx(_components.th,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Use Case`})})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Settlement`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Treasury-level account used for operational liquidity and settlement management.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Auto-sweep destination, treasury management, liquidity routing, and settlement operations.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`User`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Account structure used for end-user applications and wallet orchestration.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Consumer applications, embedded wallets, user balances, and programmable wallet flows.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`types-of-wallets`,children:`Types of Wallets`}),`\n`,_jsx(_components.p,{children:`OpenXSwitch Wallet Infrastructure supports two types of wallet models designed for programmable operations, liquidity management, and user segregation:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Smart Wallets (Account Abstraction):`}),` Programmable on-chain smart contract wallets that support gasless transactions, transaction sponsorship, batch execution, and advanced policy-based permissions.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Wallets:`}),` Standard blockchain addresses provisioned under an account structure for multi-chain asset routing and custody.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`A single wallet address can be used to receive supported assets across multiple EVM chains and tokens. To learn more, see `,_jsx(_components.a,{href:`/wallet-infrastructure/unified-evm-address`,children:`Unified Wallet Addressing on EVM Chains`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`settlement-infrastructure`,children:`Settlement Infrastructure`}),`\n`,_jsx(Heading,{level:`3`,id:`what-makes-a-wallet-a-settlement-wallet`,children:`What Makes a Wallet a Settlement Wallet?`}),`\n`,_jsxs(_components.p,{children:[`A `,_jsx(_components.strong,{children:`Settlement Wallet`}),` is defined by the following characteristics:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Type Designation:`}),` Possesses the explicit role type `,_jsx(_components.code,{children:`settlement`}),` within the infrastructure configuration.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Automated Creation:`}),` Automatically created during initial workspace setup when your wallet infrastructure is provisioned.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Central Treasury Hub:`}),` Serves as the primary operational target for internal transfers, settlement flows, and workspace-level auto-sweeps.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`key-capabilities-of-an-account`,children:`Key Capabilities of an Account`}),`\n`,_jsx(_components.p,{children:`Accounts serve as administrative and logical containers for grouping wallets, users, and operational rules. Key capabilities include:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Withdrawal Execution:`}),` Execute external crypto withdrawals via both the OpenXSwitch API and the operational Dashboard.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Global Account Control (Disable/Enable):`}),` Disabling or enabling an Account immediately applies to `,_jsx(_components.strong,{children:`all wallets`}),` attached to that account.`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.em,{children:`Disabling an Account:`}),` Temporarily suspends operations and freezes outbound actions for all underlying wallets under that account.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.em,{children:`Enabling an Account:`}),` Restores operational status and API access to all wallets grouped within the account structure.`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Watchlist Configuration:`}),` Configure watchlist monitoring directly at the Account level to track and screen specific blockchain addresses for risk management.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`user-entity-attachment`,children:`User Entity Attachment`}),`\n`,_jsxs(_components.blockquote,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Note:`}),` User entities are attached `,_jsx(_components.strong,{children:`directly to specific wallets`}),` (rather than to Accounts). This enables identity mapping, user-level access management, and customer wallet orchestration directly at the individual wallet level.`]}),`\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":{"config":{},"pageMetadata":{"title":"Wallet Infrastructure: Architecture","description":"This section introduces the core concepts and wallet models used across the OpenXSwitch Wallet Infrastructure.","sidebarTitle":"Architecture","href":"/wallet-infrastructure/architecture"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Architecture Overview","slug":"architecture-overview","depth":2,"children":[]},{"title":"Types of Accounts","slug":"types-of-accounts","depth":2,"children":[]},{"title":"Types of Wallets","slug":"types-of-wallets","depth":2,"children":[]},{"title":"Settlement Infrastructure","slug":"settlement-infrastructure","depth":2,"children":[{"title":"What Makes a Wallet a Settlement Wallet?","slug":"what-makes-a-wallet-a-settlement-wallet","depth":3,"children":[]},{"title":"Key Capabilities of an Account","slug":"key-capabilities-of-an-account","depth":3,"children":[]},{"title":"User Entity Attachment","slug":"user-entity-attachment","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"subdomain":"openxswitch","siteName":"OpenXSwitch | Docs","title":"Wallet Infrastructure: Architecture - OpenXSwitch | Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-27T15:35:39.924Z","originalFileLocation":"wallet-infrastructure/architecture.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=\"This section introduces the core concepts and wallet models used across the OpenXSwitch Wallet Infrastructure.\">\u003cmeta data-mint-head name=\"application-name\" content=\"OpenXSwitch | Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/openxswitch/2ZoZSJURTKn_wXeo/_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/openxswitch/2ZoZSJURTKn_wXeo/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/openxswitch/2ZoZSJURTKn_wXeo/_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/openxswitch/2ZoZSJURTKn_wXeo/_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/openxswitch/2ZoZSJURTKn_wXeo/_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/openxswitch/2ZoZSJURTKn_wXeo/_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/openxswitch/2ZoZSJURTKn_wXeo/_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/openxswitch/2ZoZSJURTKn_wXeo/_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/openxswitch/2ZoZSJURTKn_wXeo/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Wallet Infrastructure: Architecture - OpenXSwitch | Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"This section introduces the core concepts and wallet models used across the OpenXSwitch Wallet Infrastructure.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OpenXSwitch | Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.openxswitch.com/wallet-infrastructure/architecture\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://openxswitch.mintlify.app/_mintlify/api/og/v2?division=Wallet+Infrastructure\u0026amp;title=Wallet+Infrastructure%3A+Architecture\u0026amp;description=This+section+introduces+the+core+concepts+and+wallet+models+used+across+the+OpenXSwitch+Wallet+Infrastructure.\u0026amp;theme=aa99d25cde61c886a91e18aa\u0026amp;signature=729e29fbc2db81c382c603625967072276e00322c2a498b3c22553004c537c32\">\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=\"Wallet Infrastructure: Architecture - OpenXSwitch | Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"This section introduces the core concepts and wallet models used across the OpenXSwitch Wallet Infrastructure.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://openxswitch.mintlify.app/_mintlify/api/og/v2?division=Wallet+Infrastructure\u0026amp;title=Wallet+Infrastructure%3A+Architecture\u0026amp;description=This+section+introduces+the+core+concepts+and+wallet+models+used+across+the+OpenXSwitch+Wallet+Infrastructure.\u0026amp;theme=aa99d25cde61c886a91e18aa\u0026amp;signature=729e29fbc2db81c382c603625967072276e00322c2a498b3c22553004c537c32\">\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/openxswitch/2ZoZSJURTKn_wXeo/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OpenXSwitch | Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003cmeta data-mint-head name=\"keyword\" content=\"OpenXSwitch, Wallet as a service, Smart Account, Crypto as a service, Wallet infrastructure, Sablecoin Orchestration, Stablecoin Infrastructure\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.openxswitch.com/wallet-infrastructure/architecture\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/wallet-infrastructure/architecture.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.openxswitch.com/#organization\",\"name\":\"OpenXSwitch | Docs\",\"url\":\"https://docs.openxswitch.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/openxswitch/ML35RDblT1Ol-zJb/images/LightBlog(1).png?fit=max\u0026auto=format\u0026n=ML35RDblT1Ol-zJb\u0026q=85\u0026s=062e79ad9c4540929eec204aff020178\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.openxswitch.com#website\",\"name\":\"OpenXSwitch | Docs\",\"url\":\"https://docs.openxswitch.com\",\"publisher\":{\"@id\":\"https://docs.openxswitch.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.openxswitch.com/wallet-infrastructure/architecture#webpage\",\"url\":\"https://docs.openxswitch.com/wallet-infrastructure/architecture\",\"name\":\"Wallet Infrastructure: Architecture\",\"description\":\"This section introduces the core concepts and wallet models used across the OpenXSwitch Wallet Infrastructure.\",\"dateModified\":\"2026-07-27T15:35:39.924Z\",\"isPartOf\":{\"@id\":\"https://docs.openxswitch.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.openxswitch.com/wallet-infrastructure/architecture#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.openxswitch.com/wallet-infrastructure/architecture#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Platform\",\"item\":\"https://docs.openxswitch.com/platform/supported-blockchains\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Wallet Infrastructure: Architecture\",\"item\":\"https://docs.openxswitch.com/wallet-infrastructure/architecture\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.openxswitch.com/wallet-infrastructure/architecture#article\",\"headline\":\"Wallet Infrastructure: Architecture\",\"name\":\"Wallet Infrastructure: Architecture\",\"description\":\"This section introduces the core concepts and wallet models used across the OpenXSwitch Wallet Infrastructure.\",\"url\":\"https://docs.openxswitch.com/wallet-infrastructure/architecture\",\"mainEntityOfPage\":{\"@id\":\"https://docs.openxswitch.com/wallet-infrastructure/architecture#webpage\"},\"dateModified\":\"2026-07-27T15:35:39.924Z\",\"publisher\":{\"@id\":\"https://docs.openxswitch.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.openxswitch.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OpenXSwitch | Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"OpenXSwitch | Docs","nav":{"global":null,"tabs":[{"tab":"Introduction","pages":[{"title":"Introduction","sidebarTitle":"Overview","mode":"default","href":"/introduction"},{"title":"Platform Overview","mode":"default","href":"/platform-overview"},{"title":"Technical Support and Onboarding","href":"/technical-support-and-onboarding"},{"group":"Platform","pages":[{"title":"Supported Blockchains","href":"/platform/supported-blockchains"},{"title":"Supported Assets","sidebarTitle":"Supported Assets","href":"/platform/supported-assets"},{"title":"Testnets vs Mainnets","sidebarTitle":"Testnets vs Mainnets","href":"/platform/testnet-vs-mainnet"},{"title":"Manage Team Members","href":"/platform/manage-team-members"},{"title":"API Permissions","description":"OpenXSwitch uses a granular permission-based API access system to control how applications interact with platform infrastructure, wallets, transactions, and operational services.","href":"/platform/api-permissions"},{"group":"Wallet Infrastructure","pages":[{"title":"Wallet Infrastructure: Architecture","sidebarTitle":"Architecture","href":"/wallet-infrastructure/architecture"},{"title":"Why Smart Contract Wallets","description":"Wallets are the core primitive for any on-chain transaction. They serve as the foundational entry point for stablecoins, digital asset management, and the future of global, programmable payments.","href":"/wallet-infrastructure/why-smart-contract-wallets"},{"title":"Unified EVM Address","sidebarTitle":"Unified EVM Address","href":"/wallet-infrastructure/unified-evm-address"},{"title":"Auto Collection and Sweep Rule","sidebarTitle":"Auto Collection and Sweep Rule","href":"/wallet-infrastructure/auto-collection-and-sweep-rule"}]},{"group":"Compliance Engine","pages":[{"title":"Compliance Engine","sidebarTitle":"Overview","href":"/compliance/overview"},{"title":"Watchlists","sidebarTitle":"Watchlists","href":"/compliance/watchlists"}]}]},{"group":"Swaps \u0026 Bridges","pages":[{"sidebarTitle":"Overview","title":"Swaps \u0026 Bridges","href":"/swaps"},{"title":"Refund Policy \u0026 Settlement Lifecycle","sidebarTitle":"Refund Policy \u0026 Settlement Lifecycle","href":"/swaps/refunds-and-settlement"}]},{"group":"Stock Tokens","pages":[{"title":"Stock Tokens","sidebarTitle":"Overview","href":"/stock-tokens"}]},{"group":"Gas Fees","pages":[{"title":"Overview","href":"/gas-fees/overview"},{"title":"Sponsorship Models","sidebarTitle":"Sponsorship Models","href":"/gas-fees/sponsorship-models"},{"title":"Gas Fee Faqs","sidebarTitle":"Faqs","href":"/gas-fees/faqs"}]},{"group":"Webhook","pages":[{"title":"Overview","href":"/webhook/overview"},{"title":"Webhook Events","href":"/webhook/webhook-events"},{"title":"Handling Wallet Balances","sidebarTitle":"Handling Wallet Balances","href":"/webhook/handling-wallet-balances"}]},{"title":"Glossary","hidden":true,"href":"/glossary"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/overview"}]},{"tab":"Wallet as a Service - API Reference - v1","pages":[{"title":"Wallet as a Service - API Reference - v1","href":"/api-reference-v1/overview"}]},{"tab":"Tools","hidden":true,"pages":[{"title":"Tools","href":"/tools"}]},{"tab":"Changlogs","hidden":true,"pages":[{"title":"Changlogs","href":"/changlog/smart-accounts"}]}]},"title":"Wallet Infrastructure: Architecture - OpenXSwitch | Docs","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":[],"chunks":[]}
.png?fit=max&auto=format&n=ML35RDblT1Ol-zJb&q=85&s=062e79ad9c4540929eec204aff020178)
.png?fit=max&auto=format&n=ML35RDblT1Ol-zJb&q=85&s=f6328956931c9664a2a070c2edb6e9b3)