Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

client

package

Go to main page

Versions in this module

v0

v0.3.1

Oct 19, 2026

v0.3.0

Oct 19, 2026

Changes in this version

+ const CodeAccountQuota

+ const CodeAllowanceExceeded

+ const CodeAllowanceOutOfRange

+ const CodeConflict

+ const CodeIdentityConflict

+ const CodePayloadDeleted

+ const CodePayloadNotDeletable

+ const CodeRateLimited

+ const DefaultClockTolerance

+ const DefaultVerifyRequestBurst

+ const DefaultVerifyRequestRate

+ const EvidenceFormat

+ const EvidenceFormatVersion

+ const MaxCaptureBytes

+ const MaxCapturePackets

+ const MaxEvidenceBytes

+ const MaxVerifyTagComputations

+ const ReasonAmbiguous

+ const ReasonBadKey

+ const ReasonDisclosureDelay

+ const ReasonFragment

+ const ReasonIPv6

+ const ReasonKeyPublic

+ const ReasonKeysMissing

+ const ReasonLinkType

+ const ReasonMalformed

+ const ReasonNoRun

+ const ReasonNoSigningKey

+ const ReasonNotDisclosed

+ const ReasonNotIPv4

+ const ReasonNotRetained

+ const ReasonSchedule

+ const ReasonTagMismatch

+ const ReasonTagSpec

+ const ReasonTooManyCandidates

+ const ReasonTooShort

+ const ReasonUnmatched

+ const ReasonWorkCap

+ const ServerEndpoint

+ const TagSpecVersionLegacy

+ const TagSpecVersionV1

+ var ErrEvidenceDigest = errors.New(...)

+ var ErrNoAttributionHistory = errors.New(...)

+ var ErrNoMatchingExecutor = errors.New(...)

+ func IsEvidence(prefix []byte) bool

+ func PacketDigest(items []EvidencePacket) string

+ func ReceiptKeyID(public []byte) string

+ func WriteEvidence(w io.Writer, ev Evidence) error

+ type APICredential struct

+ Audience string

+ CredentialID string

+ ExpiresAt int64

+ ID string

+ Name string

+ Role string

+ Scopes []string

+ Token string

+ type Allowance = wire.Allowance

+ type AttributionCandidate = wire.AttributionCandidate

+ type AttributionCandidates = wire.AttributionCandidates

+ type AttributionKey = wire.AttributionKey

+ type AttributionKeys = wire.AttributionKeys

+ type AttributionReceipt = wire.AttributionReceipt

+ type AttributionReceiptKey = wire.AttributionReceiptKey

+ type AttributionReceiptKeys = wire.AttributionReceiptKeys

+ type AttributionReceiptPayload = wire.AttributionReceiptPayload

+ type AttributionSchedule = wire.AttributionSchedule

+ type AttributionVerifyGroup = wire.AttributionVerifyGroup

+ type AttributionVerifyPacket = wire.AttributionVerifyPacket

+ type AttributionVerifyResponse = wire.AttributionVerifyResponse

+ type CancellationDocument = wire.Cancellation

+ type CaptureClockSchedule struct

+ ChainID string

+ ExecutorID string

+ OriginUnixNS int64

+ type CaptureClockTrust struct

+ MaxErrorNS int64

+ ObservedAt time.Time

+ PacketsDigest string

+ Schedules []CaptureClockSchedule

+ Source string

+ ValidUntil time.Time

+ func ReadCaptureClockTrust(data []byte) (CaptureClockTrust, error)

+ type CaptureError struct

+ Msg string

+ Offset int64

+ func (e *CaptureError) Error() string

+ type CapturedPacket struct

+ CapturedAt time.Time

+ Data []byte

+ LinkType uint16

+ func ReadCapture(r io.Reader) ([]CapturedPacket, error)

type Client

+ func (c *Client) Allowance(ctx context.Context) (Allowance, error)

+ func (c *Client) AttributionCandidates(ctx context.Context, ip string, at time.Time) (AttributionCandidates, error)

+ func (c *Client) AttributionKeys(ctx context.Context, executorID, chainID string, fromEpoch, toEpoch int64) (AttributionKeys, error)

+ func (c *Client) AttributionReceiptKeys(ctx context.Context) (AttributionReceiptKeys, error)

+ func (c *Client) AttributionVerify(ctx context.Context, packets []AttributionVerifyPacket) (AttributionVerifyResponse, error)

+ func (c *Client) CancelDeviceLogin(ctx context.Context, login DeviceLogin) error

+ func (c *Client) CancelExperiment(ctx context.Context, receipt ExperimentSubmission) error

+ func (c *Client) Cancellation(ctx context.Context, id string) (CancellationDocument, error)

+ func (c *Client) CredentialStatus(ctx context.Context) (CredentialStatus, error)

+ func (c *Client) DeleteProfile(ctx context.Context, id string) error

+ func (c *Client) DiscoverExecutors(ctx context.Context, filter ExecutorFilter) ([]Node, error)

+ func (c *Client) ExecutorEarnings(ctx context.Context, executorID string) (ExecutorEarnings, error)

+ func (c *Client) Export(ctx context.Context, id string) (Result, error)

+ func (c *Client) ExportExperiment(ctx context.Context, receipt ExperimentSubmission) (ExperimentResults, error)

+ func (c *Client) Measurement(ctx context.Context, id string) (Measurement, error)

+ func (c *Client) MeasurementRuns(ctx context.Context, id string, limit, offset int64) (Measurement, error)

+ func (c *Client) MeasurementTemplates(ctx context.Context) ([]MeasurementTemplate, error)

+ func (c *Client) Measurements(ctx context.Context, opts MeasurementOptions) (MeasurementPage, error)

+ func (c *Client) Orders(ctx context.Context, page OrdersPage) (OrderHistory, error)

+ func (c *Client) PollDeviceLogin(ctx context.Context, login DeviceLogin) (DeviceLoginPoll, error)

+ func (c *Client) Probes(ctx context.Context, statuses ...string) ([]Node, error)

+ func (c *Client) Profile(ctx context.Context, id string) (Profile, error)

+ func (c *Client) Profiles(ctx context.Context) ([]ProfileSummary, error)

+ func (c *Client) Quote(ctx context.Context, batch *PreparedBatch) (Quote, error)

+ func (c *Client) Recovery(ctx context.Context, id string) (RecoveryDocument, error)

+ func (c *Client) RendezvousTEST(ctx context.Context, server, peer Request, opts RendezvousOptions) (result RendezvousResult, failure error)

+ func (c *Client) RetryTEST(ctx context.Context, parentID, requestID string, batch *PreparedBatch) (Submission, error)

+ func (c *Client) RunDetail(ctx context.Context, id string) (RunDetail, error)

+ func (c *Client) SaveProfile(ctx context.Context, id string, config ProfileConfig) (Profile, error)

+ func (c *Client) SelectExecutor(ctx context.Context, id string, filter ExecutorFilter) (Node, error)

+ func (c *Client) StartDeviceLogin(ctx context.Context, label string, scopes []string) (DeviceLogin, error)

+ func (c *Client) SubmitExperimentTEST(ctx context.Context, def ExperimentDefinition) (ExperimentSubmission, error)

+ func (c *Client) Verify(ctx context.Context, packets []CapturedPacket, opts VerifyOptions) (VerifyReport, error)

+ type ControlBinding = wire.ControlBinding

+ type CredentialStatus struct

+ Audience string

+ CreatedAt int64

+ ExpiresAt int64

+ ID string

+ Kind string

+ Scopes []string

+ type DeviceLogin struct

+ Audience string

+ DeviceCode string

+ ExpiresAt int64

+ Interval int64

+ Scopes []string

+ UserCode string

+ VerificationURI string

+ type DeviceLoginPoll struct

+ Credential *APICredential

+ Interval int64

+ State string

+ type Economics = wire.Economics

+ type Evidence struct

+ At *time.Time

+ Chains []EvidenceChain

+ ClockToleranceMS int64

+ CreatedAt time.Time

+ Dispatcher EvidenceDispatcher

+ Format string

+ FormatVersion int

+ Groups []EvidenceGroup

+ Lookups []EvidenceLookup

+ Packets EvidencePackets

+ ReceiptKeys []EvidenceReceiptKey

+ Receipts []EvidenceReceipt

+ TagSpec int

+ Tool EvidenceTool

+ func ReadEvidence(r io.Reader) (Evidence, error)

+ type EvidenceCandidate struct

+ ActiveFrom time.Time

+ ActiveTo time.Time

+ DisclosedThrough int64

+ DisclosedThroughAtNs int64

+ ExecutorID string

+ IPSource string

+ NextDisclosureAtNs int64

+ RunID string

+ Schedule EvidenceSchedule

+ type EvidenceChain struct

+ ExecutorID string

+ Keys []EvidenceKey

+ Schedule EvidenceSchedule

+ type EvidenceDispatcher struct

+ APIVersion string

+ Issuer string

+ URL string

+ type EvidenceGroup struct

+ Epoch int64

+ ExecutorID string

+ Keys []EvidenceKey

+ Matched int

+ Method VerifyMethod

+ Packets []int

+ PendingUntil *time.Time

+ Reason string

+ RunID string

+ Schedule *EvidenceSchedule

+ Source string

+ Split *VerifySplit

+ Unmatched int

+ Verdict Verdict

+ type EvidenceKey struct

+ Epoch int64

+ Key []byte

+ type EvidenceLookup struct

+ At time.Time

+ Candidates []EvidenceCandidate

+ IP string

+ RetainedFrom time.Time

+ Statement *wire.AttributionReceipt

+ Truncated bool

+ type EvidenceMismatchError struct

+ Group int

+ Msg string

+ func (e *EvidenceMismatchError) Error() string

+ type EvidencePacket struct

+ CapturedAt time.Time

+ Data []byte

+ type EvidencePackets struct

+ Count int

+ Digest string

+ Items []EvidencePacket

+ type EvidenceReceipt struct

+ KeyID string

+ Packets []int

+ Payload []byte

+ Signature []byte

+ type EvidenceReceiptError struct

+ Msg string

+ Receipt int

+ func (e *EvidenceReceiptError) Error() string

+ type EvidenceReceiptKey struct

+ KeyID string

+ PublicKey []byte

+ ValidFrom time.Time

+ ValidTo *time.Time

+ type EvidenceSchedule struct

+ ChainID string

+ ChainLength int64

+ DisclosureDelayEpochs int64

+ EpochSeconds int64

+ K0 []byte

+ OperatorProof *wire.AttributionScheduleProof

+ T0UnixNs int64

+ TagSpec int64

+ type EvidenceTool struct

+ Name string

+ Version string

+ type EvidenceTrust struct

+ CaptureClock *CaptureClockTrust

+ Dispatcher string

+ ExecutorCertificates map[string][]string

+ Keys []EvidenceReceiptKey

+ func ReadEvidenceTrust(data []byte) (EvidenceTrust, error)

+ type ExecutorEarnings = wire.ExecutorEarnings

+ type ExecutorFilter struct

+ ASN uint32

+ AddressFamilies []string

+ Country string

+ EnforcementMode string

+ ISDAS string

+ MinCapacityBPS *int64

+ Protocols []string

+ ReachableListeners []string

+ func (f ExecutorFilter) Empty() bool

+ func (f ExecutorFilter) Validate() error

+ type ExperimentDefinition struct

+ Participants []ExperimentRun

+ type ExperimentResults struct

+ Results []Result

+ Submission ExperimentSubmission

+ type ExperimentRun struct

+ Args []string

+ ExecutorID string

+ OrderID int64

+ Policy Policy

+ RunID string

+ SHA256 string

+ WASMPath string

+ type ExperimentSubmission struct

+ ExperimentID string

+ Participants []ExperimentRun

type HTTPError

+ FieldErrors []wire.FieldError

+ RetryAfter time.Duration

+ type IncompleteOutputError struct

+ Output OutputStatus

+ func (e *IncompleteOutputError) Error() string

+ type Measurement = wire.Measurement

+ type MeasurementOptions struct

+ Limit int64

+ Offset int64

+ Search string

+ State string

+ type MeasurementPage = wire.MeasurementPage

+ type MeasurementTemplate = wire.MeasurementTemplate

+ type OrderHistory = wire.OrderHistory

+ type OrdersPage struct

+ Before string

+ Limit int64

+ type OutputStatus = wire.OutputStatus

+ type Profile = wire.Profile

+ type ProfileConfig = wire.ProfileConfig

+ type ProfileSummary = wire.ProfileSummary

+ type Quote = wire.Quote

+ type RateLimitedError struct

+ Err error

+ Partial bool

+ Throttled int

+ UncheckedGroups int

+ UncheckedPackets int

+ func (e *RateLimitedError) Error() string

+ func (e *RateLimitedError) Unwrap() error

+ type RecoveryDocument = wire.Recovery

+ type RecoveryObservation = wire.RecoveryObservation

+ type RecoveryObserver = wire.RecoveryObserver

+ type RendezvousOptions struct

+ Output func(role, runID string, page LogPage) error

+ ReadinessTimeout time.Duration

+ Timeout time.Duration

+ type RendezvousResult struct

+ Client RendezvousRun

+ Endpoint string

+ Server RendezvousRun

+ type RendezvousRun struct

+ Cleanup string

+ Error string

+ ExecutorID string

+ ID string

+ State string

+ TransactionID string

+ type Result = wire.Result

+ func ReadResult(r io.Reader) (Result, error)

+ type RetainedRun = wire.RetainedRun

+ type RetryLink = wire.RetryLink

+ type RunDetail = wire.RunDetail

type SubmissionError

+ AdmittedIDs []string

+ type Verdict string

+ const VerdictInvalid

+ const VerdictMissing

+ const VerdictPending

+ const VerdictUnsupported

+ const VerdictVerified

+ type VerifyCounts struct

+ Invalid int

+ Missing int

+ Pending int

+ Unsupported int

+ Verified int

+ type VerifyGroup struct

+ AmbiguousRuns []string

+ Candidates int

+ Detail string

+ DisclosedAt *time.Time

+ Epoch int64

+ ExecutorID string

+ FalseMatchBound float64

+ Matched int

+ Method VerifyMethod

+ Packets []int

+ PendingUntil *time.Time

+ Reason string

+ ReceiptKeyID string

+ RunID string

+ Source string

+ Split *VerifySplit

+ Time time.Time

+ Unmatched int

+ Verdict Verdict

+ type VerifyMethod string

+ const VerifyMethodOffline

+ const VerifyMethodServer

+ type VerifyOptions struct

+ At time.Time

+ CaptureClock *CaptureClockTrust

+ ClockTolerance time.Duration

+ Offline bool

+ RequestBurst int

+ RequestRate float64

+ type VerifyReport struct

+ At *time.Time

+ CaptureTimeTrusted bool

+ CheckedAt time.Time

+ ClockToleranceMS int64

+ Counts VerifyCounts

+ Dispatcher string

+ Groups []VerifyGroup

+ HistoryAuthenticated bool

+ Packets int

+ SchedulesAuthenticated bool

+ TagSpec string

+ func VerifyEvidence(ctx context.Context, ev Evidence) (VerifyReport, error)

+ func VerifyEvidenceWithTrust(ctx context.Context, ev Evidence, trust EvidenceTrust) (VerifyReport, error)

+ func (r VerifyReport) Evidence() Evidence

+ type VerifySplit struct

+ Matched int

+ Packets int

+ Runs []string

+ Unmatched int

v0.3.0-rc.1

Oct 6, 2026

v0.2.0

Sep 27, 2026

Changes in this version

+ const APIVersion

+ const CodeCancelRefused

+ const CodeCapacityExhausted

+ const CodeForbidden

+ const CodeIntentMismatch

+ const CodeInternal

+ const CodeInvalidPolicy

+ const CodeInvalidRequest

+ const CodeMethodNotAllowed

+ const CodeNotFound

+ const CodePayloadTooLarge

+ const CodePaymentIncomplete

+ const CodePaymentsDisabled

+ const CodeUnauthorized

+ const CodeUnavailable

+ const CodeUnknownExecutor

+ const CodeUnsupportedAPIVersion

+ const CodeUnsupportedMediaType

+ const CodeUnsupportedPaymentMethod

+ const StateExited

+ func IsTransportError(err error) bool

+ type Account struct

+ AccountKey string

+ ID string

+ Name string

+ RecoveryCode string

+ Role string

+ type Client struct

+ func New(endpoint string, options Options) (*Client, error)

+ func (c *Client) Cancel(ctx context.Context, id, executorID string) error

+ func (c *Client) Connection(ctx context.Context) (ConnectionInfo, error)

+ func (c *Client) CreateAccount(ctx context.Context, name string) (Account, error)

+ func (c *Client) Login(ctx context.Context, accountKey string) (Session, error)

+ func (c *Client) Logout(ctx context.Context) error

+ func (c *Client) Logs(ctx context.Context, id string, options LogOptions) (LogPage, error)

+ func (c *Client) Nodes(ctx context.Context) ([]Node, error)

+ func (c *Client) Recover(ctx context.Context, recoveryCode string) (Account, error)

+ func (c *Client) Status(ctx context.Context, id string) (State, error)

+ func (c *Client) SubmitTEST(ctx context.Context, batch *PreparedBatch) (Submission, error)

+ func (c *Client) Version(ctx context.Context) (ServerVersion, error)

+ func (c *Client) Whoami(ctx context.Context) (User, error)

+ func (c *Client) WithCredential(token string) (*Client, error)

+ type ConnectionInfo struct

+ GRPCAddress string

+ Mode string

+ SchemaVersion int

+ YamuxAddress string

+ type HTTPError struct

+ Code string

+ Message string

+ Method string

+ Path string

+ StatusCode int

+ func (e *HTTPError) Error() string

+ type LogEntry struct

+ ID int64

+ Output []byte

+ Timestamp string

+ type LogOptions struct

+ After int64

+ Limit int64

+ type LogPage struct

+ After int64

+ Error string

+ HasMore bool

+ Logs []LogEntry

+ State string

+ type Node struct

+ Currency string

+ ID string

+ LastSeen int64

+ PricePerBw int64

+ Ready bool

+ TeslaAnchorKey []byte

+ TeslaAnchorTimestampNs int64

+ TeslaDelaySec int64

+ Version string

+ type Options struct

+ AllowRemoteTEST bool

+ Credential string

+ HTTPClient *http.Client

+ RequestTimeout time.Duration

+ type Policy struct

+ Addresses []string

+ CeilBW int64

+ FloorBW int64

+ ListenSCION bool

+ ListenTCP bool

+ ListenUDP bool

+ RequireICMP bool

+ TimeoutMS int64

+ type PreparedBatch struct

+ func Prepare(requests []Request) (*PreparedBatch, error)

+ type Request struct

+ Args []string

+ ExecutorID string

+ OrderID int64

+ Policy Policy

+ StartTimestamp *int64

+ Wasm []byte

+ type ServerVersion struct

+ APIVersion string

+ APIVersions []string

+ BinaryRevision string

+ BinaryVersion string

+ ProtocolVersion string

+ Version string

+ type Session struct

+ CSRFToken string

+ ExpiresAt int64

+ ID string

+ Name string

+ Role string

+ Token string

+ type State struct

+ Error string

+ ExecutorID string

+ State string

+ type Submission struct

+ IDs []string

+ TransactionID string

+ type SubmissionError struct

+ Err error

+ OutcomeUnknown bool

+ Stage string

+ TransactionID string

+ func (e *SubmissionError) Code() string

+ func (e *SubmissionError) Error() string

+ func (e *SubmissionError) Unwrap() error

+ type User struct

+ ID string

+ Name string

+ Role string

v0.2.0-rc.3

Sep 26, 2026

v0.2.0-rc.2

Sep 26, 2026

v0.2.0-rc.1

Sep 25, 2026