satellite/payments: add coinpayments HTTP client (#3181)
This commit is contained in:
Yaroslav Vorobiov
GitHub
parent
451909b3ec
commit
535742d37e
104
satellite/payments/coinpayments/client.go
Normal file
104
satellite/payments/coinpayments/client.go
Normal file
@ -0,0 +1,104 @@
|
||||
// Copyright (C) 2019 Storj Labs, Inc.
|
||||
// See LICENSE for copying information.
|
||||
|
||||
package coinpayments
|
||||
|
||||
import (
|
||||
"bytes"
|
||||
"context"
|
||||
"crypto/hmac"
|
||||
"crypto/sha512"
|
||||
"encoding/hex"
|
||||
"encoding/json"
|
||||
"net/http"
|
||||
"net/url"
|
||||
|
||||
"github.com/zeebo/errs"
|
||||
)
|
||||
|
||||
// Error is error class API errors.
|
||||
var Error = errs.Class("coinpayments client error")
|
||||
|
||||
// Credentials contains public and private API keys for client.
|
||||
type Credentials struct {
|
||||
PublicKey string
|
||||
PrivateKey string
|
||||
}
|
||||
|
||||
// Client handles base API processing.
|
||||
type Client struct {
|
||||
creds Credentials
|
||||
http http.Client
|
||||
}
|
||||
|
||||
// NewClient creates new instance of client with provided credentials.
|
||||
func NewClient(creds Credentials) *Client {
|
||||
client := &Client{
|
||||
creds: creds,
|
||||
http: http.Client{
|
||||
Timeout: 0,
|
||||
},
|
||||
}
|
||||
return client
|
||||
}
|
||||
|
||||
// Transactions returns transactions API.
|
||||
func (c *Client) Transactions() Transactions {
|
||||
return Transactions{client: c}
|
||||
}
|
||||
|
||||
// do handles base API request routines.
|
||||
func (c *Client) do(ctx context.Context, cmd string, values url.Values) (_ json.RawMessage, err error) {
|
||||
values.Set("version", "1")
|
||||
values.Set("format", "json")
|
||||
values.Set("key", c.creds.PublicKey)
|
||||
values.Set("cmd", cmd)
|
||||
|
||||
encoded := values.Encode()
|
||||
|
||||
buff := bytes.NewBufferString(encoded)
|
||||
|
||||
req, err := http.NewRequest(http.MethodPost, "https://www.coinpayments.net/api.php", buff)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
|
||||
req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
|
||||
req.Header.Set("HMAC", c.hmac([]byte(encoded)))
|
||||
|
||||
resp, err := c.http.Do(req.WithContext(ctx))
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
|
||||
defer func() {
|
||||
err = errs.Combine(err, resp.Body.Close())
|
||||
}()
|
||||
|
||||
if resp.StatusCode != http.StatusOK {
|
||||
return nil, errs.New("internal server error")
|
||||
}
|
||||
|
||||
var data struct {
|
||||
Error string `json:"error"`
|
||||
Result json.RawMessage `json:"result"`
|
||||
}
|
||||
|
||||
if err = json.NewDecoder(resp.Body).Decode(&data); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
|
||||
if data.Error != "ok" {
|
||||
return nil, errs.New(data.Error)
|
||||
}
|
||||
|
||||
return data.Result, nil
|
||||
}
|
||||
|
||||
// hmac returns string representation of HMAC signature
|
||||
// signed with clients private key.
|
||||
func (c *Client) hmac(payload []byte) string {
|
||||
mac := hmac.New(sha512.New, []byte(c.creds.PrivateKey))
|
||||
_, _ = mac.Write(payload)
|
||||
return hex.EncodeToString(mac.Sum(nil))
|
||||
}
|
||||
328
satellite/payments/coinpayments/transactions.go
Normal file
328
satellite/payments/coinpayments/transactions.go
Normal file
@ -0,0 +1,328 @@
|
||||
// Copyright (C) 2019 Storj Labs, Inc.
|
||||
// See LICENSE for copying information.
|
||||
|
||||
package coinpayments
|
||||
|
||||
import (
|
||||
"context"
|
||||
"encoding/json"
|
||||
"fmt"
|
||||
"math/big"
|
||||
"net/url"
|
||||
"strconv"
|
||||
"strings"
|
||||
"time"
|
||||
|
||||
"github.com/zeebo/errs"
|
||||
)
|
||||
|
||||
const (
|
||||
cmdCreateTransaction = "create_transaction"
|
||||
cmdGetTransactionInfo = "get_tx_info"
|
||||
cmdGetTransactionInfoList = "get_tx_info_multi"
|
||||
)
|
||||
|
||||
// Currency is a type wrapper for defined currencies.
|
||||
type Currency string
|
||||
|
||||
const (
|
||||
// CurrencyUSD defines USD.
|
||||
CurrencyUSD Currency = "USD"
|
||||
// CurrencyLTCT defines LTCT, coins used for testing purpose.
|
||||
CurrencyLTCT Currency = "LTCT"
|
||||
)
|
||||
|
||||
// String returns Currency string representation
|
||||
func (c Currency) String() string {
|
||||
return string(c)
|
||||
}
|
||||
|
||||
// Status is a type wrapper for transaction statuses.
|
||||
type Status int
|
||||
|
||||
const (
|
||||
// StatusCancelled defines cancelled or timeout transaction.
|
||||
StatusCancelled Status = -1
|
||||
// StatusPending defines pending transaction which is waiting for buyer funds.
|
||||
StatusPending Status = 0
|
||||
// StatusReceived defines transaction which successfully received required amount of funds.
|
||||
StatusReceived Status = 1
|
||||
)
|
||||
|
||||
// Int returns int representation of status.
|
||||
func (s Status) Int() int {
|
||||
return int(s)
|
||||
}
|
||||
|
||||
// String returns string representation of status.
|
||||
func (s Status) String() string {
|
||||
switch s {
|
||||
case StatusCancelled:
|
||||
return "cancelled/timeout"
|
||||
case StatusPending:
|
||||
return "pending"
|
||||
case StatusReceived:
|
||||
return "received"
|
||||
default:
|
||||
return "unknown"
|
||||
}
|
||||
}
|
||||
|
||||
// TransactionID is type wrapper for transaction id.
|
||||
type TransactionID string
|
||||
|
||||
// String returns string representation of transaction id.
|
||||
func (id TransactionID) String() string {
|
||||
return string(id)
|
||||
}
|
||||
|
||||
// TransactionIDList is a type wrapper for list of transactions.
|
||||
type TransactionIDList []TransactionID
|
||||
|
||||
// Encode returns encoded string representation of transaction id list.
|
||||
func (list TransactionIDList) Encode() string {
|
||||
if len(list) == 0 {
|
||||
return ""
|
||||
}
|
||||
if len(list) == 1 {
|
||||
return string(list[0])
|
||||
}
|
||||
|
||||
var builder strings.Builder
|
||||
for _, id := range list[:len(list)-1] {
|
||||
builder.WriteString(string(id))
|
||||
builder.WriteString("|")
|
||||
}
|
||||
|
||||
builder.WriteString(string(list[len(list)-1]))
|
||||
return builder.String()
|
||||
}
|
||||
|
||||
// Transaction contains data returned on transaction creation.
|
||||
type Transaction struct {
|
||||
ID TransactionID
|
||||
Address string
|
||||
Amount big.Float
|
||||
DestTag string
|
||||
ConfirmsNeeded int
|
||||
Timeout time.Duration
|
||||
CheckoutURL string
|
||||
StatusURL string
|
||||
QRCodeURL string
|
||||
}
|
||||
|
||||
// UnmarshalJSON handles json unmarshaling for transaction.
|
||||
func (tx *Transaction) UnmarshalJSON(b []byte) error {
|
||||
var txRaw struct {
|
||||
Amount string `json:"amount"`
|
||||
Address string `json:"address"`
|
||||
DestTag string `json:"dest_tag"`
|
||||
TxID string `json:"txn_id"`
|
||||
ConfirmsNeeded string `json:"confirms_needed"`
|
||||
Timeout int `json:"timeout"`
|
||||
CheckoutURL string `json:"checkout_url"`
|
||||
StatusURL string `json:"status_url"`
|
||||
QRCodeURL string `json:"qrcode_url"`
|
||||
}
|
||||
|
||||
if err := json.Unmarshal(b, &txRaw); err != nil {
|
||||
return err
|
||||
}
|
||||
|
||||
amount := new(big.Float).SetPrec(big.MaxPrec)
|
||||
|
||||
_, err := fmt.Sscan(txRaw.Amount, amount)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
|
||||
confirms, err := strconv.ParseInt(txRaw.ConfirmsNeeded, 10, 64)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
|
||||
*tx = Transaction{
|
||||
ID: TransactionID(txRaw.TxID),
|
||||
Address: txRaw.Address,
|
||||
Amount: *amount,
|
||||
DestTag: txRaw.DestTag,
|
||||
ConfirmsNeeded: int(confirms),
|
||||
Timeout: time.Second * time.Duration(txRaw.Timeout),
|
||||
CheckoutURL: txRaw.CheckoutURL,
|
||||
StatusURL: txRaw.StatusURL,
|
||||
QRCodeURL: txRaw.QRCodeURL,
|
||||
}
|
||||
|
||||
return nil
|
||||
}
|
||||
|
||||
// TransactionInfo holds transaction information.
|
||||
type TransactionInfo struct {
|
||||
Address string
|
||||
Coin Currency
|
||||
Amount big.Float
|
||||
Received big.Float
|
||||
ConfirmsReceived int
|
||||
Status Status
|
||||
ExpiresAt time.Time
|
||||
CreatedAt time.Time
|
||||
}
|
||||
|
||||
// UnmarshalJSON handles json unmarshaling for transaction info.
|
||||
func (info *TransactionInfo) UnmarshalJSON(b []byte) error {
|
||||
var txInfoRaw struct {
|
||||
Address string `json:"payment_address"`
|
||||
Coin string `json:"coin"`
|
||||
Status int `json:"status"`
|
||||
AmountF string `json:"amountf"`
|
||||
ReceivedF string `json:"receivedf"`
|
||||
ConfirmsRecv int `json:"recv_confirms"`
|
||||
ExpiresAt int64 `json:"time_expires"`
|
||||
CreatedAt int64 `json:"time_created"`
|
||||
}
|
||||
|
||||
if err := json.Unmarshal(b, &txInfoRaw); err != nil {
|
||||
return err
|
||||
}
|
||||
|
||||
amount := new(big.Float).SetPrec(big.MaxPrec)
|
||||
received := new(big.Float).SetPrec(big.MaxPrec)
|
||||
|
||||
_, err := fmt.Sscan(txInfoRaw.AmountF, amount)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
_, err = fmt.Sscan(txInfoRaw.ReceivedF, received)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
|
||||
*info = TransactionInfo{
|
||||
Address: txInfoRaw.Address,
|
||||
Coin: Currency(txInfoRaw.Coin),
|
||||
Amount: *amount,
|
||||
Received: *received,
|
||||
ConfirmsReceived: txInfoRaw.ConfirmsRecv,
|
||||
Status: Status(txInfoRaw.Status),
|
||||
ExpiresAt: time.Unix(txInfoRaw.ExpiresAt, 0),
|
||||
CreatedAt: time.Unix(txInfoRaw.CreatedAt, 0),
|
||||
}
|
||||
|
||||
return nil
|
||||
}
|
||||
|
||||
// TransactionInfos is map of transaction infos by transaction id.
|
||||
type TransactionInfos map[TransactionID]TransactionInfo
|
||||
|
||||
// UnmarshalJSON handles json unmarshaling for TransactionInfos.
|
||||
func (infos *TransactionInfos) UnmarshalJSON(b []byte) error {
|
||||
var _infos map[TransactionID]TransactionInfo
|
||||
|
||||
var errors map[TransactionID]struct {
|
||||
Error string `json:"error"`
|
||||
}
|
||||
|
||||
if err := json.Unmarshal(b, &errors); err != nil {
|
||||
return err
|
||||
}
|
||||
|
||||
var errg errs.Group
|
||||
for _, info := range errors {
|
||||
if info.Error != "ok" {
|
||||
errg.Add(errs.New(info.Error))
|
||||
}
|
||||
}
|
||||
|
||||
if err := errg.Err(); err != nil {
|
||||
return err
|
||||
}
|
||||
|
||||
if err := json.Unmarshal(b, &_infos); err != nil {
|
||||
return err
|
||||
}
|
||||
|
||||
for id, info := range _infos {
|
||||
(*infos)[id] = info
|
||||
}
|
||||
|
||||
return nil
|
||||
}
|
||||
|
||||
// CreateTX defines parameters for transaction creating.
|
||||
type CreateTX struct {
|
||||
Amount float64
|
||||
CurrencyIn Currency
|
||||
CurrencyOut Currency
|
||||
BuyerEmail string
|
||||
}
|
||||
|
||||
// Transactions defines transaction related API methods.
|
||||
type Transactions struct {
|
||||
client *Client
|
||||
}
|
||||
|
||||
// Create creates new transaction.
|
||||
func (t Transactions) Create(ctx context.Context, params CreateTX) (*Transaction, error) {
|
||||
amount := strconv.FormatFloat(params.Amount, 'f', -1, 64)
|
||||
|
||||
values := make(url.Values)
|
||||
values.Set("amount", amount)
|
||||
values.Set("currency1", params.CurrencyIn.String())
|
||||
values.Set("currency2", params.CurrencyOut.String())
|
||||
values.Set("buyer_email", params.BuyerEmail)
|
||||
|
||||
tx := new(Transaction)
|
||||
|
||||
res, err := t.client.do(ctx, cmdCreateTransaction, values)
|
||||
if err != nil {
|
||||
return nil, Error.Wrap(err)
|
||||
}
|
||||
|
||||
if err = json.Unmarshal(res, tx); err != nil {
|
||||
return nil, Error.Wrap(err)
|
||||
}
|
||||
|
||||
return tx, nil
|
||||
}
|
||||
|
||||
// Info receives transaction info by transaction id.
|
||||
func (t Transactions) Info(ctx context.Context, id TransactionID) (*TransactionInfo, error) {
|
||||
values := make(url.Values)
|
||||
values.Set("txid", id.String())
|
||||
|
||||
txInfo := new(TransactionInfo)
|
||||
|
||||
res, err := t.client.do(ctx, cmdGetTransactionInfo, values)
|
||||
if err != nil {
|
||||
return nil, Error.Wrap(err)
|
||||
}
|
||||
|
||||
if err = json.Unmarshal(res, txInfo); err != nil {
|
||||
return nil, Error.Wrap(err)
|
||||
}
|
||||
|
||||
return txInfo, nil
|
||||
}
|
||||
|
||||
// ListInfos returns up to 25 transaction infos.
|
||||
func (t Transactions) ListInfos(ctx context.Context, ids TransactionIDList) (TransactionInfos, error) {
|
||||
if len(ids) > 25 {
|
||||
return nil, Error.New("only up to 25 transactions can be queried")
|
||||
}
|
||||
|
||||
values := make(url.Values)
|
||||
values.Set("txid", ids.Encode())
|
||||
|
||||
txInfos := make(TransactionInfos, len(ids))
|
||||
|
||||
res, err := t.client.do(ctx, cmdGetTransactionInfoList, values)
|
||||
if err != nil {
|
||||
return nil, Error.Wrap(err)
|
||||
}
|
||||
|
||||
if err = json.Unmarshal(res, &txInfos); err != nil {
|
||||
return nil, Error.Wrap(err)
|
||||
}
|
||||
|
||||
return txInfos, nil
|
||||
}
|
||||
Loading…
Reference in New Issue
Block a user