/api/transactions/locker/put-one-coin

const API_HOST = 'http://localhost:8080';

// Upload exactly one coin of a given denomination and get its serial number
async function lockerPutOneCoin(lockerKey, denomination, walletPath = null) {
    let url = `${API_HOST}/api/transactions/locker/put-one-coin?` +
              `locker_key=${encodeURIComponent(lockerKey)}&` +
              `denomination=${denomination}`;

    if (walletPath) {
        url += `&wallet_path=${encodeURIComponent(walletPath)}`;
    }

    const response = await fetch(url);
    const result = await response.json();

    if (result.status === 'success') {
        console.log(`Uploaded 1 coin (denom ${result.denomination})`);
        console.log(`Serial Number: ${result.serial_number}`);
        console.log(`RAIDAs confirmed: ${result.successful_uploads}/25`);
    } else {
        console.error('Upload failed:', result.message);
    }
    return result;
}

// Examples:

// Upload one 1 CC coin and get its serial number
lockerPutOneCoin('CUP-1974', 1);

// Upload one 100 CC coin
lockerPutOneCoin('GIFT-CODE', 100);

// Upload one 0.01 CC coin (1 cent)
lockerPutOneCoin('PENNY', 0.01);

// Upload one 1000 CC coin from specific wallet
lockerPutOneCoin('BIG-ONE', 1000, 'E:/Wallets/MyWallet');

package main

import (
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
    "net/url"
)

const ApiHost = "http://localhost:8080"

type PutOneCoinResponse struct {
    Status            string  `json:"status"`
    Operation         string  `json:"operation"`
    Denomination      float64 `json:"denomination"`
    SerialNumber      int     `json:"serial_number"`
    AmountUploaded    int     `json:"amount_uploaded"`
    CoinsUploaded     int     `json:"coins_uploaded"`
    LockerKey         string  `json:"locker_key"`
    SuccessfulUploads int     `json:"successful_uploads"`
    Message           string  `json:"message"`
    TaskID            string  `json:"task_id"`
}

// Upload exactly one coin by denomination and get its serial number
func putOneCoin(lockerKey string, denomination float64, walletPath string) (*PutOneCoinResponse, error) {
    params := url.Values{}
    params.Add("locker_key", lockerKey)
    params.Add("denomination", fmt.Sprintf("%g", denomination))
    if walletPath != "" {
        params.Add("wallet_path", walletPath)
    }

    fullURL := fmt.Sprintf("%s/api/transactions/locker/put-one-coin?%s",
                           ApiHost, params.Encode())

    resp, err := http.Get(fullURL)
    if err != nil {
        return nil, err
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    var result PutOneCoinResponse
    json.Unmarshal(body, &result)
    return &result, nil
}

func main() {
    // Upload one 1 CC coin
    result, err := putOneCoin("CUP-1974", 1.0, "")
    if err != nil {
        fmt.Printf("Error: %v\n", err)
        return
    }

    fmt.Printf("Status: %s\n", result.Status)
    fmt.Printf("Denomination: %g CC\n", result.Denomination)
    fmt.Printf("Serial Number: %d\n", result.SerialNumber)
    fmt.Printf("RAIDAs confirmed: %d/25\n", result.SuccessfulUploads)

    // Upload one 100 CC coin
    result, _ = putOneCoin("GIFT-CODE", 100.0, "")
    fmt.Printf("100 CC coin SN: %d (%d/25 RAIDAs)\n",
               result.SerialNumber, result.SuccessfulUploads)

    // Upload one 0.01 CC coin (1 cent)
    result, _ = putOneCoin("PENNY", 0.01, "")
    fmt.Printf("Cent coin SN: %d (%d/25 RAIDAs)\n",
               result.SerialNumber, result.SuccessfulUploads)
}