> ## Documentation Index
> Fetch the complete documentation index at: https://cobo.com/products/agentic-wallet/manual/llms.txt
> Use this file to discover all available pages before exploring further.

# Wallets

> Create wallets, inspect wallet state, list wallets, and update metadata.

Wallets are created and owned by a principal. Owners have unrestricted access; runtimes only see wallets they can access through active delegations or pacts.

## Create a wallet

<Tabs>
  <Tab title="CLI">
    ```bash theme={null}
    caw onboard
    ```
  </Tab>

  <Tab title="Python SDK">
    ```python theme={null}
    wallet = await owner_client.create_wallet(name="Treasury")
    print(wallet["uuid"])
    ```
  </Tab>

  <Tab title="TypeScript SDK">
    ```typescript theme={null}
    const wallet = (await walletsApi.createWallet({ name: 'Treasury' })).data.result;
    console.log(wallet.uuid);
    ```
  </Tab>
</Tabs>

## Get a wallet

<Tabs>
  <Tab title="CLI">
    ```bash theme={null}
    caw wallet get
    ```
  </Tab>

  <Tab title="Python SDK">
    ```python theme={null}
    wallet = await owner_client.get_wallet(wallet_uuid)
    print(wallet["name"], wallet["status"])
    ```
  </Tab>

  <Tab title="TypeScript SDK">
    ```typescript theme={null}
    const wallet = (await walletsApi.getWallet(walletUuid)).data.result;
    console.log(wallet.name, wallet.status);
    ```
  </Tab>
</Tabs>

## List wallets

<Tabs>
  <Tab title="CLI">
    ```bash theme={null}
    caw wallet list
    ```
  </Tab>

  <Tab title="Python SDK">
    ```python theme={null}
    wallets = await owner_client.list_wallets(limit=50, offset=0)
    ```
  </Tab>

  <Tab title="TypeScript SDK">
    ```typescript theme={null}
    const wallets = (await walletsApi.listWallets(undefined, undefined, 0, 50)).data.result;
    ```
  </Tab>
</Tabs>

## Update wallet metadata

<Tabs>
  <Tab title="Python SDK">
    ```python theme={null}
    from cobo_agentic_wallet_api.models.wallet_update import WalletUpdate

    await owner_client.update_wallet(
        wallet_uuid,
        WalletUpdate(name="Main Treasury", metadata={"region": "us-east"}),
    )
    ```
  </Tab>

  <Tab title="TypeScript SDK">
    ```typescript theme={null}
    await walletsApi.updateWallet(walletUuid, {
      name: 'Main Treasury',
      metadata: { region: 'us-east' },
    });
    ```
  </Tab>
</Tabs>