# Wallet Management

## Overview

The BlocWise Wallet API enables you to create and manage different types of blockchain wallets through RESTful endpoints. This guide will help you understand the basics and get started with wallet integration.

### Quick Start

```bash
# Create a new wallet
curl -X POST https://api.bloclabs.com/v1/wallets/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "mpc",
    "network": "ethereum",
    "label": "My First Wallet"
  }'
```

### Wallet Types

We support four types of wallets, each designed for specific use cases:

#### 1. MPC Wallet (Recommended)

Best for applications requiring high security and institutional-grade features.

```bash
POST /v1/wallets/create
```

Request:

```json
{
    "type": "mpc",
    "network": "ethereum",
    "label": "Secure Trading Wallet",
    "environment": "mainnet"
}
```

Response:

```json
{
    "status": "success",
    "data": {
        "wallet_id": "wallet_123abc",
        "address": "0x123...abc",
        "type": "mpc",
        "network": "ethereum",
        "label": "Secure Trading Wallet",
        "created_at": "2024-03-15T10:30:00Z"
    }
}
```

**Key Features:**

* Distributed key generation
* No single point of failure
* Enterprise-grade security
* Multi-signature support

#### 2. HD Wallet

Ideal for personal wallets and standard cryptocurrency applications.

```bash
POST /v1/wallets/create
```

Request:

```json
{
    "type": "hd",
    "network": "polygon",
    "label": "Personal Wallet",
    "environment": "mainnet"
}
```

Response:

```json
{
    "status": "success",
    "data": {
        "wallet_id": "wallet_456def",
        "address": "0x456...def",
        "type": "hd",
        "network": "polygon",
        "label": "Personal Wallet",
        "created_at": "2024-03-15T10:35:00Z"
    }
}
```

#### 3. Watch Wallet

Perfect for portfolio tracking and monitoring addresses.

```bash
POST /v1/wallets/watch
```

Request:

```json
{
    "address": "0x789...ghi",
    "network": "ethereum",
    "label": "Portfolio Tracker",
    "notifications": {
        "large_transfers": true,
        "incoming_transactions": true
    }
}
```

Response:

```json
{
    "status": "success",
    "data": {
        "wallet_id": "watch_789ghi",
        "address": "0x789...ghi",
        "type": "watch",
        "network": "ethereum",
        "label": "Portfolio Tracker"
    }
}
```

### Common Operations

#### Checking Wallet Balance

```bash
GET /v1/wallets/{wallet_id}/balance
```

Response:

```json
{
    "status": "success",
    "data": {
        "balance": "1.5",
        "currency": "ETH",
        "usd_value": "3000.00",
        "updated_at": "2024-03-15T10:40:00Z"
    }
}
```

#### Sending Transactions

```bash
POST /v1/wallets/{wallet_id}/transfer
```

Request:

```json
{
    "to": "0x789...def",
    "amount": "1.5",
    "asset": "ETH",
    "gas_priority": "medium"
}
```

Response:

```json
{
    "status": "success",
    "data": {
        "transaction_id": "tx_123abc",
        "status": "pending",
        "hash": "0xabc...",
        "estimated_completion_time": "2024-03-15T10:45:00Z"
    }
}
```

#### Get Transaction Status

```bash
GET /v1/wallets/{wallet_id}/transactions/{transaction_id}
```

Response:

```json
{
    "status": "success",
    "data": {
        "transaction_id": "tx_123abc",
        "status": "confirmed",
        "hash": "0xabc...",
        "block_number": 15481234,
        "confirmations": 12
    }
}
```

### Error Handling

Common error responses:

```json
{
    "status": "error",
    "message": "Invalid network specified",
    "errors": [
        {
            "type": "validation_error",
            "message": "Network must be one of: ethereum, polygon, binance",
            "field": "network"
        }
    ]
}
```

### Best Practices

#### Security

1. Always verify transaction details
2. Implement proper error handling
3. Use appropriate authentication methods
4. Regular security audits

#### Performance

1. Cache wallet data when appropriate
2. Batch balance updates
3. Implement proper error handling
4. Use webhooks for real-time updates

### Next Steps

* Advanced Wallet Operations
* Transaction Management
* Security Best Practices
* API Reference


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bloclabs.com/api/core-concepts/wallet-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.