payment

Documentation

Overview

control of payment verification

Index

• Constants
• func Finalise()
• func GetPayments(ownerData []byte, previousTransfer *transactionrecord.BitmarkTransfer) []*transactionrecord.Payment
• func Initialise(configuration *Configuration) error
• func ScaledDifficulty(count int) *difficulty.Difficulty
• type Configuration
• type PayNonce
  • func NewPayNonce() PayNonce
  • func Store(payments []*transactionrecord.Payment, payId reservoir.PayId, count int, ...) (PayNonce, *difficulty.Difficulty, error)
  • func (paynonce PayNonce) GoString() string
  • func (paynonce PayNonce) MarshalText() ([]byte, error)
  • func (paynonce PayNonce) String() string
  • func (paynonce *PayNonce) UnmarshalText(s []byte) error
• type TrackingStatus
  • func TrackPayment(payId reservoir.PayId, receipt string, confirmations uint64) TrackingStatus
  • func TryProof(payId reservoir.PayId, clientNonce []byte) TrackingStatus
  • func (ts TrackingStatus) MarshalText() ([]byte, error)
  • func (ts TrackingStatus) String() string
  • func (ts *TrackingStatus) UnmarshalText(s []byte) error

Constants

const (
	ReceiptLength         = 64 // hex bytes
	NonceLength           = 64 // hex bytes
	RequiredConfirmations = 3
)

maximum values

Functions

func Finalise

func Finalise()

stop all payment handlers

func GetPayments

func GetPayments(ownerData []byte, previousTransfer *transactionrecord.BitmarkTransfer) []*transactionrecord.Payment

get payment record from a specific block given the blocks 8 byte big endian key

func Initialise

func Initialise(configuration *Configuration) error

create the tables

func ScaledDifficulty

func ScaledDifficulty(count int) *difficulty.Difficulty

produce a scaled difficulty based on the number of items in a block to be processed and include a quantity discount

Types

type Configuration

type Configuration struct {
	Bitcoin *bitcoin.Configuration
}

configuration for each sub-module

type PayNonce

type PayNonce [8]byte

type to represent a payment nonce Note: no reversal is required for this

func NewPayNonce

func NewPayNonce() PayNonce

create a random pay nonce

func Store

func Store(payments []*transactionrecord.Payment, payId reservoir.PayId, count int, canProof bool) (PayNonce, *difficulty.Difficulty, error)

store an incoming record for payment

func (PayNonce) GoString

func (paynonce PayNonce) GoString() string

convert a binary pay nonce to big endian hex string for use by the fmt package (for %#v)

func (PayNonce) MarshalText

func (paynonce PayNonce) MarshalText() ([]byte, error)

convert pay nonce to big endian hex text

func (PayNonce) String

func (paynonce PayNonce) String() string

convert a binary pay nonce to big endian hex string for use by the fmt package (for %s)

func (*PayNonce) UnmarshalText

func (paynonce *PayNonce) UnmarshalText(s []byte) error

convert little endian hex text into a pay nonce

type TrackingStatus

type TrackingStatus int

result of track payment/try proof

const (
	TrackingNotFound  TrackingStatus = iota
	TrackingAccepted  TrackingStatus = iota
	TrackingProcessed TrackingStatus = iota
	TrackingInvalid   TrackingStatus = iota
)

possible status values

func TrackPayment

func TrackPayment(payId reservoir.PayId, receipt string, confirmations uint64) TrackingStatus

start payment tracking on an receipt

func TryProof

func TryProof(payId reservoir.PayId, clientNonce []byte) TrackingStatus

instead of paying, try a proof from the client nonce

func (TrackingStatus) MarshalText

func (ts TrackingStatus) MarshalText() ([]byte, error)

convert the tracking value for JSON

func (TrackingStatus) String

func (ts TrackingStatus) String() string

convert the tracking value for printf

func (*TrackingStatus) UnmarshalText

func (ts *TrackingStatus) UnmarshalText(s []byte) error

convert the tracking value from JSON to enumeration