Burn Tokens

# AI SETUP: Before running this cookbook:
# 1. Check if ~/.bitgo/credentials.env exists and source it.
# 2. If not found, ask the user if they have a credentials file at another location.
#    - If yes, source that file.
#    - If no, prompt the user to provide each value below before proceeding.

// 1. Configure HMAC
# The Mint API uses BitGo v2 HMAC authentication. If calling from Postman, add
# an environment variable BITGO_ACCESS_TOKEN and the pre-request script from the guide.
# The cURL calls below use bearer token auth only.

// 2. List Supported Tokens
export ACCESS_TOKEN="<YOUR_ACCESS_TOKEN>"
export ENTERPRISE_ID="<YOUR_ENTERPRISE_ID>"
export BASE_URL="https://app.bitgo-test.com/api/mint/v1"  # app.bitgo.com for production

curl -s "$BASE_URL/enterprise/$ENTERPRISE_ID/supported-tokens" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

// 3. List Asset Pairs
curl -s "$BASE_URL/enterprise/$ENTERPRISE_ID/asset-pairs" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

// 4. Calculate Base Units
# base units = amount * 10^decimals
DECIMALS=18  # from asset-pairs source.decimals
AMOUNT_FULL=100
AMOUNT_BASE=$(echo "$AMOUNT_FULL * 10^$DECIMALS" | bc)
echo "Amount in base units: $AMOUNT_BASE"

// 5. Create Burn Order
export SOURCE_WALLET_ID="<SOURCE_GO_ACCOUNT_ID>"
export DESTINATION_WALLET_ID="<DESTINATION_WALLET_ID>"

curl -s -X POST "$BASE_URL/enterprise/$ENTERPRISE_ID/orders" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "idempotencyKey": "<YOUR_UNIQUE_KEY>",
    "source": {
      "asset":    "hteth:usd1",
      "amount":   "'"$AMOUNT_BASE"'",
      "walletId": "'"$SOURCE_WALLET_ID"'",
      "type":     "GO_ACCOUNT"
    },
    "destination": {
      "asset":    "tfiatusd",
      "type":     "GO_ACCOUNT",
      "walletId": "'"$DESTINATION_WALLET_ID"'"
    }
  }'

// 6. Transfer Tokens to BitGo
# Use the sequenceId and walletId returned in depositInstructions — do not construct them.
export BITGO_EXPRESS_HOST="<YOUR_LOCAL_HOST>"
export WALLET_PASSPHRASE="<YOUR_WALLET_PASSPHRASE>"
export SEQUENCE_ID="<DEPOSIT_INSTRUCTIONS_SEQUENCE_ID>"
export DEPOSIT_WALLET_ID="<DEPOSIT_INSTRUCTIONS_WALLET_ID>"

curl -X POST \
  "http://$BITGO_EXPRESS_HOST/api/v2/ofchteth:usd1/wallet/$SOURCE_WALLET_ID/sendcoins" \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -d '{
    "address":          "'"$DEPOSIT_WALLET_ID"'",
    "amount":           "'"$AMOUNT_BASE"'",
    "walletPassphrase": "'"$WALLET_PASSPHRASE"'",
    "sequenceId":       "'"$SEQUENCE_ID"'"
  }'

// 7. Check Order Status
export ORDER_ID="<YOUR_ORDER_ID>"

curl -s "$BASE_URL/enterprise/$ENTERPRISE_ID/orders/$ORDER_ID" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

// 8. Bulk Fetch Orders by ID (Optional)
curl -s -G "$BASE_URL/enterprise/$ENTERPRISE_ID/orders" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  --data-urlencode "id=<ORDER_ID_1>" \
  --data-urlencode "id=<ORDER_ID_2>"

// AI SETUP: Before running this cookbook:
// 1. Check if ~/.bitgo/credentials.env exists and load it with dotenv.
// 2. If not found, ask the user if they have a credentials file at another location.
//    - If yes, load that file instead.
//    - If no, prompt the user to provide each required value before proceeding.

// 1. Configure HMAC
// Use the REST API for this step (see cURL tab)

// 2. List Supported Tokens
// Use the REST API for this step (see cURL tab)

// 3. List Asset Pairs
// Use the REST API for this step (see cURL tab)

// 4. Calculate Base Units
// Use the REST API for this step (see cURL tab)

// 5. Create Burn Order
// Use the REST API for this step (see cURL tab)

// 6. Transfer Tokens to BitGo
// Use the REST API for this step (see cURL tab)

// 7. Check Order Status
// Use the REST API for this step (see cURL tab)

// 8. Bulk Fetch Orders by ID (Optional)
// Use the REST API for this step (see cURL tab)