Agentic Installation

Implement a complete Ground sandbox integration in this codebase.
Read https://docs.groundtech.co/docs/agentic-installation in full, including
its implementation checklist, selected product procedure, and acceptance checks.
Read the linked operation guides and current OpenAPI request/response schemas
before coding their endpoints. Follow their links when an operation is conditional.

1. Inspect the application framework, existing account model, authentication,
   backend routes, database, wallet provider, signing, UI, and tests.
   Choose Portfolio Wallets, MicroVaults, or gTokens from balance ownership and
   signer responsibility. Explain the choice. Ask only for missing choices that
   change ownership, permission, fees, receiver, or fund movement. Inspect existing
   configuration before asking. Never guess credentials, enabled access, or assets.
2. Use https://sandbox.groundtech.co and its current product catalog. Verify access,
   networks, deployed interfaces, test funding, and the authorized signer.
   Never substitute production funds or networks when a sandbox flow is blocked.
3. Implement the application integration, not just discovery calls: backend API
   client and authorization, durable account/resource mapping, stable identities
   for logical writes, signer and approval flows, funding/subscription, balance
   and yield display, withdrawal/redemption, and any request/claim step.
   Reuse this repository's conventions, wallet provider, storage, and test tools.
4. Build pending/error/completed states and recovery. Persist operation identity
   before submission; restore tracking after refresh or restart. Reconcile webhooks
   and receipts with current API/onchain reads. Treat decimal amounts precisely.
   Keep API keys server-side. Do not guess contract methods or duplicate an
   uncertain operation with a new request ID or wallet transaction.
5. Run the project's relevant checks, meaningful mocked recovery tests, and a
   real sandbox funding-to-withdrawal round trip when access/funding/signing permit.
   Confirm actual assets or shares and final receiver delivery. An accepted API
   response, submitted transaction, or queued settlement is not completion.
6. Deliver changed files, setup instructions, checks run, redacted environment
   details, resource IDs, transaction hashes, initial/final balances, and evidence
   for every acceptance check. Separate mocked, simulated, confirmed, and pending
   evidence. If blocked, finish independent work, preserve resumable state, and
   state the exact prerequisite and next action. Do not claim an untested flow works.
   Optional: submit one concise redacted finding using this page's feedback section.
Do not use production funds or deploy the integration without explicit authorization.

export BASE_URL="https://sandbox.groundtech.co"
curl -sS "$BASE_URL/v2/wallets/yield-sources" \
  -H "Authorization: Bearer $GROUND_API_KEY"

export GROUND_API="https://sandbox.groundtech.co"
curl -sS "$GROUND_API/v2/microvaults/vaults" \
  -H "Authorization: Bearer $GROUND_API_KEY"
curl -sS "$GROUND_API/v2/microvaults/yield-sources?chainId=11155111" \
  -H "Authorization: Bearer $GROUND_API_KEY"

curl -sS https://sandbox.groundtech.co/v2/gvaults/yield-sources \
  -H "Authorization: Bearer $GROUND_API_KEY"

curl -sS -X POST "https://sandbox.groundtech.co/v2/integration-feedback" \
  -H "Authorization: Bearer $GROUND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "submissionId": "57dc48f3-2163-4f92-888a-3fa1b03bbcc7",
    "product": "gtokens",
    "category": "docs_mismatch",
    "stage": "source_discovery",
    "title": "The example asset does not match the selected network",
    "expected": "The example uses the sandbox network asset",
    "observed": "The address in the example differs from the returned sandbox catalog",
    "docsUrl": "https://docs.groundtech.co/docs/gtokens/discover-yield-sources",
    "agent": { "name": "codex" },
    "evidence": {
      "reproductionSteps": ["Read the example and compare it with the sandbox catalog"]
    }
  }'

{
  "id": "103f836d-2cac-4aa7-a830-c086321d139b",
  "submissionId": "57dc48f3-2163-4f92-888a-3fa1b03bbcc7",
  "status": "received",
  "createdAt": "2026-10-08T23:00:00.000Z"
}