solana-go/rpc/getSignaturesForAddress.go

76 lines
2.2 KiB
Go

package rpc
import (
"context"
"github.com/gagliardetto/solana-go"
)
type GetSignaturesForAddressOpts struct {
// (optional) Maximum transaction signatures to return (between 1 and 1,000, default: 1,000).
Limit *int `json:"limit,omitempty"`
// (optional) Start searching backwards from this transaction signature.
// If not provided the search starts from the top of the highest max confirmed block.
Before solana.Signature `json:"before,omitempty"`
// (optional) Search until this transaction signature, if found before limit reached.
Until solana.Signature `json:"until,omitempty"`
// (optional) Commitment; "processed" is not supported.
// If parameter not provided, the default is "finalized".
Commitment CommitmentType `json:"commitment,omitempty"`
}
// GetSignaturesForAddress returns confirmed signatures for transactions
// involving an address backwards in time from the provided signature
// or most recent confirmed block.
//
// NEW: This method is only available in solana-core v1.7 or newer.
// Please use `getConfirmedSignaturesForAddress2` for solana-core v1.6
func (cl *Client) GetSignaturesForAddress(
ctx context.Context,
account solana.PublicKey,
) (out []*TransactionSignature, err error) {
return cl.GetSignaturesForAddressWithOpts(
ctx,
account,
nil,
)
}
// GetSignaturesForAddressWithOpts returns confirmed signatures for transactions
// involving an address backwards in time from the provided signature
// or most recent confirmed block.
//
// NEW: This method is only available in solana-core v1.7 or newer.
// Please use `getConfirmedSignaturesForAddress2` for solana-core v1.6
func (cl *Client) GetSignaturesForAddressWithOpts(
ctx context.Context,
account solana.PublicKey,
opts *GetSignaturesForAddressOpts,
) (out []*TransactionSignature, err error) {
params := []interface{}{account}
if opts != nil {
obj := M{}
if opts.Limit != nil {
obj["limit"] = opts.Limit
}
if !opts.Before.IsZero() {
obj["before"] = opts.Before
}
if !opts.Until.IsZero() {
obj["until"] = opts.Until
}
if opts.Commitment != "" {
obj["commitment"] = opts.Commitment
}
if len(obj) > 0 {
params = append(params, obj)
}
}
err = cl.rpcClient.CallForInto(ctx, &out, "getSignaturesForAddress", params)
return
}