# Digamber Vault

> Digamber Vault is an enterprise multi-chain USDT custodial platform and digital vault protocol supporting BNB Smart Chain (BEP-20), TRON (TRC-20), and Ethereum (ERC-20). It provides zero-fee internal UID transfers, segregated HD wallet derivation, atomic double-entry ledger settlement, and authoritative developer REST APIs for automated payment verification.

## Core Facts & Official Identity
- **Official Name**: Digamber Vault
- **Official Domain**: https://www.digamber.in
- **Official API Domain**: https://api.digamber.in
- **API Base Path**: https://api.digamber.in/v1
- **Supported Asset**: Tether USD (USDT) strictly isolated across 3 chains
- **Supported Networks**:
  - BNB Smart Chain (BSC / BEP-20) · Contract: `0x55d398326f99059fF775485246999027B3197955` · Decimals: 18 · 15 Confirmations
  - TRON Network (TRC-20) · Contract: `TR7NHqJEKQxGTCi8q8ZY4pL8otSzgjLj6t` · Decimals: 6 · 19 Confirmations
  - Ethereum Mainnet (ERC-20) · Contract: `0xdAC17F958D2ee523a2206206994597C13D831ec7` · Decimals: 6 · 12 Confirmations
- **Fee Schedule**:
  - Deposit Fee: 0.00 USDT (100% Free)
  - Internal UID Transfer Network Fee: 0.00 USDT
  - Internal UID Transfer Platform Fee: 0.00 USDT
  - External Withdrawal Platform Fee: 0.00 USDT (Zero markup, pay only live blockchain gas/energy)

---

## Developer REST API & Payment Verification

Digamber Vault provides an authoritative REST API for programmatic balance queries, transaction reconciliation, and automated USDT payment verification.

### Base URL
```
https://api.digamber.in/v1
```
(Also mirrored on `https://www.digamber.in/v1`)

### Authentication
Authenticate requests using standard Bearer Token header or HMAC-SHA256 signature headers.

#### Method 1: Bearer Token (Recommended for server-to-server)
Generate an API key in the Digamber Vault Developer Console (`dg_live_...`). Include it in the `Authorization` header:
```http
Authorization: Bearer dg_live_your_api_key_here
```

#### Method 2: HMAC-SHA256 Signatures
- `X-API-KEY`: Public API Key
- `X-TIMESTAMP`: Current Unix millisecond timestamp (rejected if skewed > 30s)
- `X-SIGNATURE`: HMAC-SHA256 hex signature over `timestamp + method + path + body`

---

## Payment Verification Endpoints

### 1. Verify Payment by Transaction Hash or Deposit ID
**Endpoint**: `GET /v1/deposits/:id`  
**Description**: Look up an incoming payment by either its internal deposit UUID or its **Blockchain Transaction Hash (txHash)**.

#### Request Example (cURL):
```bash
curl -X GET "https://api.digamber.in/v1/deposits/0x7b2f4c5e3d1a890123456789abcdef0123456789abcdef0123456789abcdef01" \
  -H "Authorization: Bearer dg_live_your_api_key_here" \
  -H "Accept: application/json"
```

#### Response Example (200 OK):
```json
{
  "success": true,
  "data": {
    "id": "e4b52c01-7fa1-4a11-82d9-1123456789ab",
    "chain": "BSC",
    "network": "BEP20",
    "token": "USDT",
    "amount": "100.000000",
    "status": "CONFIRMED",
    "txHash": "0x7b2f4c5e3d1a890123456789abcdef0123456789abcdef0123456789abcdef01",
    "fromAddress": "0x1234567890123456789012345678901234567890",
    "depositAddress": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
    "blockNumber": 38459201,
    "createdAt": "2026-10-06T00:00:00.000Z"
  }
}
```

### 2. List Verified Deposits
**Endpoint**: `GET /v1/deposits?chain=bsc&limit=20`  
**Description**: Returns paginated list of deposits. Filter by `chain`: `bsc`, `tron`, or `eth`.

### 3. Check Multi-Chain Balances
**Endpoint**: `GET /v1/balances`  
**Description**: Returns available and locked USDT balances segregated by blockchain.
```json
{
  "success": true,
  "data": {
    "bsc": { "available": "250.000000", "locked": "0.000000" },
    "tron": { "available": "120.000000", "locked": "0.000000" },
    "eth": { "available": "0.000000", "locked": "0.000000" }
  }
}
```

### 4. Get User Deposit Addresses
**Endpoint**: `GET /v1/wallets`  
**Description**: Returns on-chain deposit addresses for BSC, TRON, and Ethereum.

### 5. Estimate Withdrawal Network Fee
**Endpoint**: `GET /v1/withdrawals/estimate-fee?chain=bsc&amount=50`  
**Description**: Returns live dynamic miner gas / energy cost and net amount recipient receives.

### 6. Programmatic Withdrawal
**Endpoint**: `POST /v1/withdrawals`  
**Permission Required**: `READ_AND_TRANSACT`  
**Headers**: `Idempotency-Key: <unique-uuid>`  
**Body**:
```json
{
  "chain": "bsc",
  "toAddress": "0xRecipientAddress...",
  "amount": "50.00"
}
```

---

## Ready Integration Code Examples

### Node.js (JavaScript / TypeScript)
```javascript
const API_BASE = 'https://api.digamber.in/v1';
const API_KEY = process.env.DIGAMBER_API_KEY || 'dg_live_YOUR_KEY';

async function verifyPayment(txHash) {
  const res = await fetch(`${API_BASE}/deposits/${txHash}`, {
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Accept': 'application/json'
    }
  });
  const json = await res.json();
  if (json.success && json.data.status === 'CONFIRMED') {
    return {
      verified: true,
      amount: parseFloat(json.data.amount),
      chain: json.data.chain,
      from: json.data.fromAddress
    };
  }
  return { verified: false, status: json.data?.status || 'NOT_FOUND' };
}
```

### Python
```python
import requests
import os

API_BASE = "https://api.digamber.in/v1"
API_KEY = os.getenv("DIGAMBER_API_KEY", "dg_live_YOUR_KEY")

def verify_payment(tx_hash: str):
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Accept": "application/json"
    }
    response = requests.get(f"{API_BASE}/deposits/{tx_hash}", headers=headers)
    data = response.json()
    if data.get("success") and data.get("data", {}).get("status") == "CONFIRMED":
        deposit = data["data"]
        return {
            "verified": True,
            "amount": float(deposit["amount"]),
            "chain": deposit["chain"],
            "from_address": deposit["fromAddress"]
        }
    return {"verified": False, "status": data.get("data", {}).get("status", "NOT_FOUND")}
```

### PHP
```php
<?php
function verifyDigamberPayment($txHash, $apiKey) {
    $url = "https://api.digamber.in/v1/deposits/" . urlencode($txHash);
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        "Authorization: Bearer " . $apiKey,
        "Accept: application/json"
    ]);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $result = curl_exec($ch);
    curl_close($ch);
    
    $json = json_decode($result, true);
    if (!empty($json['success']) && ($json['data']['status'] ?? '') === 'CONFIRMED') {
        return [
            'verified' => true,
            'amount' => (float)$json['data']['amount'],
            'chain' => $json['data']['chain']
        ];
    }
    return ['verified' => false];
}
```

---

## Frequently Asked Questions (FAQ)

### Digamber Vault kya hai?
Digamber Vault ek enterprise multi-chain USDT custodial banking platform hai jahan users apne digital assets ko secure HD derivation wallets, double-entry ledger, zero-fee internal UID transfer aur developer APIs ke through manage kar sakte hain.

### Kya Digamber Vault India ka crypto bank / custodial platform hai?
Haan, Digamber Vault India aur global users ke liye live INR fiat valuation, zero-fee internal UID transfer settlement, aur BSC, TRON tatha Ethereum par isolated digital vault infrastructure provide karta hai.

### Digamber Vault kaunse networks support karta hai?
Digamber Vault USDT ke liye teen major blockchains support karta hai: BNB Smart Chain (BEP-20), TRON (TRC-20), aur Ethereum (ERC-20). Teeno chains ke balances strictly isolated ledgers mein maintain kiye jaate hain. Cross-chain transfer prohibited hai.

### Digamber Vault mein USDT kaise deposit hota hai?
Har user ko apne account mein BSC, TRON aur Ethereum ke liye unique on-chain deposit addresses milte hain. Jab user un addresses par USDT transfer karta hai, automated BullMQ scanner workers block confirmations count karke funds ko automatically credit karte hain. Deposit fee 0 USDT hai.

### Digamber Vault se withdrawal kaise hota hai?
Withdrawal do-step process hai: pehle recipient address aur amount enter kiya jaata hai, phir confirmation screen par live network fee estimate review karke user ko apna 6-digit Google Authenticator (TOTP) code enter karna hota hai. Verification ke baad transaction on-chain broadcast hoti hai.

### Internal UID Transfer kya hai aur iski fees kitni hai?
Internal UID Transfer Digamber Vault ke do registered users ke beech off-chain balance transfer feature hai. User recipient ka 8-character UID ya full UUID daal kar bina kisi blockchain delay ke instantly funds send kar sakta hai. Iski Network Fee 0.00 USDT aur Platform Fee 0.00 USDT hai (100% free).

### Concurrency aur race conditions se protection kaise hoti hai?
Internal transfer engine PostgreSQL transactional advisory locks (`pg_advisory_xact_lock`) aur database-level unique partial index (`internal_transfers_sender_idempotency_unique`) use karta hai. Same idempotency key ke concurrent requests hone par exact 1 financial transfer commit hota hai aur baki requests ko safe idempotent response return hota hai.

---

## Links & Documentation Catalog
- Official Website: https://www.digamber.in
- Interactive API Docs: https://api.digamber.in/v1/docs
- Full API Reference: https://www.digamber.in/api-docs
- OpenAPI Spec (JSON): https://www.digamber.in/openapi.json
- LLM Guide: https://www.digamber.in/llms.txt
- Robots Protocol: https://www.digamber.in/robots.txt
- XML Sitemap: https://www.digamber.in/sitemap.xml