The vault authority controls strategy, fees, shareholder access, pauses, and source permissions. By default, this is your organization’s Turnkey authority and Ground submits the changes you authorize. You can export an individual vault to another wallet or smart-contract authority, after which that authority becomes responsible for operating it.
Only approved shareholder wallets may subscribe or receive shares. The vault stores a compact onchain commitment to that list, called a Merkle root. The proof endpoint returns the data a wallet transaction needs to show that an address is on the current list. See Manage shareholders for the update procedure.
Target allocations describe where the vault should hold its assets. Source modes separately control whether the vault may enter or exit each source. Changing a mode does not erase an existing position or change its target allocation.
The management fee is an annual percentage of shareholder capital. The performance fee applies only to gains above the vault’s previous high-water NAV. Both fees accrue by minting shares to the configured fee recipient, which avoids removing base assets from the strategy.
While Ground manages the vault, automation moves assets toward the target strategy, responds to subscriptions and redemptions, and completes asynchronous source operations. Its onchain permissions limit which sources and vault actions it can use.
NAV per share reflects the vault’s idle assets, yield-source positions, in-flight operations, and redemption liabilities. It determines how many shares a subscription receives and how much base asset a redemption returns.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ground","description":"Ground developer documentation for Portfolio Wallets, gtokens, MicroVaults, and webhooks.","colors":{"primary":"#0F172A","light":"#334155","dark":"#0F172A"},"logo":{"light":"https://mintcdn.com/braid-4d08f2b7/T2beshx6Z6tR-K1c/docs/assets/ground-logo-mark-white-on-black.svg?fit=max\u0026auto=format\u0026n=T2beshx6Z6tR-K1c\u0026q=85\u0026s=2b62d5630a4091f5e3fa3291cf94e7cc","dark":"https://mintcdn.com/braid-4d08f2b7/T2beshx6Z6tR-K1c/docs/assets/ground-logo-mark-white-on-black.svg?fit=max\u0026auto=format\u0026n=T2beshx6Z6tR-K1c\u0026q=85\u0026s=2b62d5630a4091f5e3fa3291cf94e7cc","href":"https://groundtech.co"},"favicon":{"light":"https://mintcdn.com/braid-4d08f2b7/T2beshx6Z6tR-K1c/docs/assets/favicon.svg?fit=max\u0026auto=format\u0026n=T2beshx6Z6tR-K1c\u0026q=85\u0026s=b4171decaf67f0eb8c4959bbf7e273bc","dark":"https://mintcdn.com/braid-4d08f2b7/T2beshx6Z6tR-K1c/docs/assets/favicon.svg?fit=max\u0026auto=format\u0026n=T2beshx6Z6tR-K1c\u0026q=85\u0026s=b4171decaf67f0eb8c4959bbf7e273bc"},"api":{"playground":{"proxy":true}},"footer":{"links":[{"header":"Docs","items":[{"label":"Introduction","href":"/docs/introduction"},{"label":"Quickstart","href":"/docs/portfolio-wallets/quickstart"},{"label":"API Conventions","href":"/docs/portfolio-wallets/api-conventions"},{"label":"Portfolio Wallets","href":"/docs/portfolio-wallets/create-wallet"},{"label":"MicroVaults","href":"/docs/microvaults/introduction"}]},{"header":"Reference","items":[{"label":"Portfolio Wallet API","href":"/api-reference/list-portfolio-assets"},{"label":"gtoken API","href":"/api-reference/list-gtoken-yield-sources"},{"label":"MicroVault API","href":"/api-reference/list-microvaults"}]}]},"seo":{"metatags":{"og:type":"website","og:site_name":"Ground","og:image":"https://docs.groundtech.co/docs/assets/og/og-default.png","og:image:width":"1200","og:image:height":"630","og:image:alt":"Ground developer documentation","twitter:card":"summary_large_image","twitter:site":"@ground_onchain","twitter:image":"https://docs.groundtech.co/docs/assets/og/og-default.png"},"paths":[{"path":"docs/portfolio-wallets","metatags":{"og:image":"https://docs.groundtech.co/docs/assets/og/og-portfolio-wallets.png","og:image:alt":"Ground Portfolio Wallets","twitter:image":"https://docs.groundtech.co/docs/assets/og/og-portfolio-wallets.png"}},{"path":"docs/gtokens","metatags":{"og:image":"https://docs.groundtech.co/docs/assets/og/og-gtokens.png","og:image:alt":"Ground gtokens","twitter:image":"https://docs.groundtech.co/docs/assets/og/og-gtokens.png"}},{"path":"docs/microvaults","metatags":{"og:image":"https://docs.groundtech.co/docs/assets/og/og-microvaults.png","og:image:alt":"Ground MicroVaults","twitter:image":"https://docs.groundtech.co/docs/assets/og/og-microvaults.png"}}]},"fonts":{"heading":{"family":"Inter","weight":600},"body":{"family":"Inter","weight":400}},"styling":{"codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":true},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"interaction":{"drilldown":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"braid-4d08f2b7","hasAudioNarration":false,"actualSubdomain":"braid-4d08f2b7","customDomains":["docs.groundtech.co"],"gitSource":{"type":"github","owner":"ground-technology","repo":"ground-monorepo","deployBranch":"mintlify-deployment","contentDirectory":"apps/api/mintlify","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af4fd0933c90bc1d790c815","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"API Reference","count":71},{"language":"default","tag":"Portfolio Wallets","count":61},{"language":"default","tag":"MicroVaults","count":36},{"language":"default","tag":"gtokens","count":33},{"language":"default","tag":"Overview","count":18},{"language":"default","tag":"Getting Started","count":16},{"language":"default","tag":"Webhooks","count":12},{"language":"default","tag":"Vaults and Sources","count":10},{"language":"default","tag":"Wallet Lifecycle","count":9},{"language":"default","tag":"Wallets","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":"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":"llms-txt-v2","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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"docs/microvaults/concepts","slug":"/docs/microvaults/concepts","pageMetadata":{"title":"Concepts and control model","description":null,"href":"/docs/microvaults/concepts"},"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`,p:`p`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`vault-and-shares`,children:`Vault and shares`}),`\n`,_jsx(_components.p,{children:`Each MicroVault accepts one base asset and issues its own ERC-20 shares. The vault contract address is also the share-token address.`}),`\n`,_jsx(Heading,{level:`2`,id:`authority`,children:`Authority`}),`\n`,_jsx(_components.p,{children:`The vault authority controls strategy, fees, shareholder access, pauses, and source permissions. By default, this is your organization’s Turnkey authority and Ground submits the changes you authorize. You can export an individual vault to another wallet or smart-contract authority, after which that authority becomes responsible for operating it.`}),`\n`,_jsx(Heading,{level:`2`,id:`shareholder-policy`,children:`Shareholder policy`}),`\n`,_jsxs(_components.p,{children:[`Only approved shareholder wallets may subscribe or receive shares. The vault stores a compact onchain commitment to that list, called a Merkle root. The proof endpoint returns the data a wallet transaction needs to show that an address is on the current list. See `,_jsx(_components.a,{href:`/docs/microvaults/shareholders`,children:`Manage shareholders`}),` for the update procedure.`]}),`\n`,_jsx(Heading,{level:`2`,id:`source-modes-and-strategy`,children:`Source modes and strategy`}),`\n`,_jsx(_components.p,{children:`Target allocations describe where the vault should hold its assets. Source modes separately control whether the vault may enter or exit each source. Changing a mode does not erase an existing position or change its target allocation.`}),`\n`,_jsx(Heading,{level:`2`,id:`fees`,children:`Fees`}),`\n`,_jsx(_components.p,{children:`The management fee is an annual percentage of shareholder capital. The performance fee applies only to gains above the vault’s previous high-water NAV. Both fees accrue by minting shares to the configured fee recipient, which avoids removing base assets from the strategy.`}),`\n`,_jsx(Heading,{level:`2`,id:`ground-management`,children:`Ground management`}),`\n`,_jsx(_components.p,{children:`While Ground manages the vault, automation moves assets toward the target strategy, responds to subscriptions and redemptions, and completes asynchronous source operations. Its onchain permissions limit which sources and vault actions it can use.`}),`\n`,_jsx(Heading,{level:`2`,id:`valuation`,children:`Valuation`}),`\n`,_jsx(_components.p,{children:`NAV per share reflects the vault’s idle assets, yield-source positions, in-flight operations, and redemption liabilities. It determines how many shares a subscription receives and how much base asset a redemption returns.`})]})}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","dark":"github-dark"}},"config":{},"pageMetadata":{"title":"Concepts and control model","description":null,"href":"/docs/microvaults/concepts"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Vault and shares","slug":"vault-and-shares","depth":2,"children":[]},{"title":"Authority","slug":"authority","depth":2,"children":[]},{"title":"Shareholder policy","slug":"shareholder-policy","depth":2,"children":[]},{"title":"Source modes and strategy","slug":"source-modes-and-strategy","depth":2,"children":[]},{"title":"Fees","slug":"fees","depth":2,"children":[]},{"title":"Ground management","slug":"ground-management","depth":2,"children":[]},{"title":"Valuation","slug":"valuation","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"braid-4d08f2b7","siteName":"Ground","title":"Concepts and control model - Ground","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-11T23:41:11.249Z","originalFileLocation":"docs/microvaults/concepts.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=\"application-name\" content=\"Ground\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/braid-4d08f2b7/aZx8N-g1imgxwXxV/_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/braid-4d08f2b7/aZx8N-g1imgxwXxV/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/braid-4d08f2b7/aZx8N-g1imgxwXxV/_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/braid-4d08f2b7/aZx8N-g1imgxwXxV/_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/braid-4d08f2b7/aZx8N-g1imgxwXxV/_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/braid-4d08f2b7/aZx8N-g1imgxwXxV/_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/braid-4d08f2b7/aZx8N-g1imgxwXxV/_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/braid-4d08f2b7/aZx8N-g1imgxwXxV/_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/braid-4d08f2b7/aZx8N-g1imgxwXxV/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Concepts and control model - Ground\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ground\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.groundtech.co/docs/microvaults/concepts\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.groundtech.co/docs/assets/og/og-microvaults.png\">\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=\"Concepts and control model - Ground\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.groundtech.co/docs/assets/og/og-microvaults.png\">\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/braid-4d08f2b7/aZx8N-g1imgxwXxV/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ground\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0F172A\">\u003cmeta data-mint-head name=\"og:image:alt\" content=\"Ground MicroVaults\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.groundtech.co/docs/microvaults/concepts\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/microvaults/concepts.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.groundtech.co/#organization\",\"name\":\"Ground\",\"url\":\"https://docs.groundtech.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/braid-4d08f2b7/T2beshx6Z6tR-K1c/docs/assets/ground-logo-mark-white-on-black.svg?fit=max\u0026auto=format\u0026n=T2beshx6Z6tR-K1c\u0026q=85\u0026s=2b62d5630a4091f5e3fa3291cf94e7cc\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.groundtech.co#website\",\"name\":\"Ground\",\"url\":\"https://docs.groundtech.co\",\"publisher\":{\"@id\":\"https://docs.groundtech.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.groundtech.co/docs/microvaults/concepts#webpage\",\"url\":\"https://docs.groundtech.co/docs/microvaults/concepts\",\"name\":\"Concepts and control model\",\"dateModified\":\"2026-11-11T23:41:11.249Z\",\"isPartOf\":{\"@id\":\"https://docs.groundtech.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.groundtech.co/docs/microvaults/concepts#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.groundtech.co/docs/microvaults/concepts#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Getting Started\",\"item\":\"https://docs.groundtech.co/docs/microvaults/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Concepts and control model\",\"item\":\"https://docs.groundtech.co/docs/microvaults/concepts\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.groundtech.co/docs/microvaults/concepts#article\",\"headline\":\"Concepts and control model\",\"name\":\"Concepts and control model\",\"url\":\"https://docs.groundtech.co/docs/microvaults/concepts\",\"mainEntityOfPage\":{\"@id\":\"https://docs.groundtech.co/docs/microvaults/concepts#webpage\"},\"image\":\"https://docs.groundtech.co/docs/assets/og/og-microvaults.png\",\"dateModified\":\"2026-11-11T23:41:11.249Z\",\"publisher\":{\"@id\":\"https://docs.groundtech.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.groundtech.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ground\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Ground\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/microvaults/concepts.md","siteName":"Ground","nav":{"global":null,"tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":"/docs/introduction"}]},{"tab":"Portfolio Wallets","pages":[{"title":"Portfolio Wallets","href":"/docs/portfolio-wallets/introduction"}]},{"tab":"gtokens","pages":[{"title":"gtokens","href":"/docs/gtokens/introduction"}]},{"tab":"MicroVaults","groups":[{"group":"Getting Started","pages":[{"title":"MicroVaults","href":"/docs/microvaults/introduction"},{"title":"MicroVault quickstart","description":"Create and inspect a sandbox MicroVault.","href":"/docs/microvaults/quickstart"},{"title":"Concepts and control model","href":"/docs/microvaults/concepts"},{"title":"Supported chains and yield sources","description":null,"href":"/docs/microvaults/supported-chains-and-sources"}]},{"group":"Vault Lifecycle","pages":[{"title":"Create a MicroVault","href":"/docs/microvaults/create-vault"},{"title":"Manage shareholders","href":"/docs/microvaults/shareholders"},{"title":"Configure strategy and source modes","href":"/docs/microvaults/strategy"},{"title":"Configure fees","href":"/docs/microvaults/fees"},{"title":"Subscribe from an external wallet","href":"/docs/microvaults/subscribe"},{"title":"Redeem MicroVault shares","href":"/docs/microvaults/redeem"},{"title":"Export vault authority","href":"/docs/microvaults/export-authority"}]},{"group":"Operations","pages":[{"title":"Use emergency controls","href":"/docs/microvaults/emergency-controls"},{"title":"Synchronous and asynchronous operations","href":"/docs/microvaults/async-operations"},{"title":"Statuses, activity, and performance","href":"/docs/microvaults/status-and-performance"},{"title":"Sandbox testing","href":"/docs/microvaults/sandbox-testing"}]},{"group":"Resources","pages":[{"title":"MicroVault contracts","href":"/docs/microvaults/contracts"},{"title":"Security and trust model","href":"/docs/microvaults/security"}]},{"group":"API Reference","pages":[{"group":"Vaults and Sources","pages":[{"title":"List MicroVaults","openapi":"swagger/swagger-combined.yaml GET /v2/microvaults/vaults","href":"/api-reference/list-microvaults"},{"title":"Create a MicroVault","openapi":"swagger/swagger-combined.yaml POST /v2/microvaults/vaults","href":"/api-reference/create-microvault"},{"title":"Get a MicroVault","openapi":"swagger/swagger-combined.yaml GET /v2/microvaults/vaults/{vaultId}","href":"/api-reference/get-microvault"},{"title":"List MicroVault yield sources","openapi":"swagger/swagger-combined.yaml GET /v2/microvaults/yield-sources","href":"/api-reference/list-microvault-yield-sources"},{"title":"List MicroVault source positions","openapi":"swagger/swagger-combined.yaml GET /v2/microvaults/vaults/{vaultId}/sources","href":"/api-reference/list-microvault-sources"},{"title":"Update MicroVault strategy","openapi":"swagger/swagger-combined.yaml PUT /v2/microvaults/vaults/{vaultId}/strategy","href":"/api-reference/update-microvault-strategy"},{"title":"Update MicroVault source mode","openapi":"swagger/swagger-combined.yaml PUT /v2/microvaults/vaults/{vaultId}/sources/{sourceId}/mode","href":"/api-reference/update-microvault-source-mode"},{"title":"Update MicroVault fees","openapi":"swagger/swagger-combined.yaml PUT /v2/microvaults/vaults/{vaultId}/fees","href":"/api-reference/update-microvault-fees"},{"title":"Update MicroVault pause controls","openapi":"swagger/swagger-combined.yaml PUT /v2/microvaults/vaults/{vaultId}/pause","href":"/api-reference/update-microvault-pause"},{"title":"Get MicroVault pause status","openapi":"swagger/swagger-combined.yaml GET /v2/microvaults/vaults/{vaultId}/pause-status","href":"/api-reference/get-microvault-pause-status"}]},{"group":"Performance and Activity","pages":[{"title":"Get MicroVault performance summary","openapi":"swagger/swagger-combined.yaml GET /v2/microvaults/performance-summary","href":"/api-reference/get-microvault-performance-summary"},{"title":"Get MicroVault performance series","openapi":"swagger/swagger-combined.yaml GET /v2/microvaults/vaults/{vaultId}/performance-series","href":"/api-reference/get-microvault-performance-series"},{"title":"List MicroVault activity","openapi":"swagger/swagger-combined.yaml GET /v2/microvaults/vaults/{vaultId}/activity","href":"/api-reference/list-microvault-activity"}]},{"group":"Shareholders","pages":[{"title":"Get MicroVault shareholders","openapi":"swagger/swagger-combined.yaml GET /v2/microvaults/vaults/{vaultId}/shareholders","href":"/api-reference/get-microvault-shareholders"},{"title":"Add a MicroVault shareholder","openapi":"swagger/swagger-combined.yaml PUT /v2/microvaults/vaults/{vaultId}/shareholders/{walletAddress}","href":"/api-reference/add-microvault-shareholder"},{"title":"Remove a MicroVault shareholder","openapi":"swagger/swagger-combined.yaml DELETE /v2/microvaults/vaults/{vaultId}/shareholders/{walletAddress}","href":"/api-reference/remove-microvault-shareholder"},{"title":"Get shareholder proof","openapi":"swagger/swagger-combined.yaml GET /v2/microvaults/vaults/{vaultId}/shareholders/{walletAddress}/proof","href":"/api-reference/get-microvault-shareholder-proof"}]},{"group":"Redemptions","pages":[{"title":"Preview a MicroVault redemption","openapi":"swagger/swagger-combined.yaml POST /v2/microvaults/vaults/{vaultId}/redemptions/preview","href":"/api-reference/preview-microvault-redemption"},{"title":"Get a requested redemption","openapi":"swagger/swagger-combined.yaml GET /v2/microvaults/vaults/{vaultId}/redemptions/{requestId}","href":"/api-reference/get-microvault-redemption"}]}]}]}]},"basePath":"","title":"Concepts and control model - Ground","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":[],"chunks":[]}