github.com/OpenAgentID/openagent-sdk-go (Go)
Unified SDKs source package and exported entry points.
Purpose
Unified SDKs package. See the linked task guide for its role in the integration.
Source contract
| Field | Value |
|---|---|
| Package | github.com/OpenAgentID/openagent-sdk-go |
| Version | source module |
| Language | Go |
| Runtime floor | 1.26.4 |
| Manifest | openagent-sdk/sdks/go/go.mod |
| Distribution | Source package; registry publication not verified |
Manifest SHA-256: 13e2f796805005c24f3b85d1ac20dc83dd83fe88dcddfd03925305914efba25c. The recorded Git revision identifies the containing repository; the manifest and entry-point hashes identify this working-tree snapshot.
Integration
Use the package root above from an authorized source checkout. Preserve sibling dependencies and their version/feature requirements. Install the runtime and compile the selected package before using its generated artifacts. The task guide describes configuration, trust boundaries, and error behavior. Test/conformance and deployment packages are supporting tools, not interchangeable production identity providers.
Exported entry points
The declarations below are extracted from the named entry files. This is a navigable source reference, not compiler-generated documentation of every transitive module. Feature gates and runtime requirements still apply. Private implementation files are not promoted to public APIs merely because they contain a public declaration.
openagent-sdk/sdks/go/openagent/act.go
Source SHA-256: 163b522ae1f48fb9cc9ef2405e444b6d7574815ad53215772152ab6f50221ff0.
const FormatVersion
const AlgorithmEd25519
const MaxActBytes
type ActClaims struct
type ActEnvelope struct
func DecodeEnvelope(token []byte) (*ActEnvelope, error)
type Verifier struct
func NewVerifier(trustedKeys [][]byte, issuer, audience string) (*Verifier, error)
func (v *Verifier) WithClock(nowUnixSeconds int64) *Verifier
func (v *Verifier) WithLeeway(seconds int64) *Verifier
func (v *Verifier) RequiringScopes(scopes ...Scope) *Verifier
func (v *Verifier) Verify(token []byte) (*ActClaims, error)
func (c *ActClaims) UnmarshalCBOR(data []byte) error
func DecodeUnverified(token []byte) (*ActClaims, bool)openagent-sdk/sdks/go/openagent/builder.go
Source SHA-256: 57ed39ad7532be7f3d8f1b2f78c97ae3015df16583ac9aa4ed48ecbb8264f4f0.
type VerifyBuilder struct
func Verify(token []byte) *VerifyBuilder
func (b *VerifyBuilder) Issuer(iss string) *VerifyBuilder
func (b *VerifyBuilder) ForAudience(audience string) *VerifyBuilder
func (b *VerifyBuilder) TrustedKeys(keys ...[]byte) *VerifyBuilder
func (b *VerifyBuilder) RequireScope(scope Scope) *VerifyBuilder
func (b *VerifyBuilder) WithLeeway(seconds int64) *VerifyBuilder
func (b *VerifyBuilder) AtTime(unixSeconds int64) *VerifyBuilder
func (b *VerifyBuilder) Run() (*ActClaims, error)openagent-sdk/sdks/go/openagent/errors.go
Source SHA-256: e36b0830b63ebd0794203eae038df34763ea15ff445b757c60762fbc72f3d66f.
type ActError struct
func (e *ActError) Error() string
type ConfigError struct
func (e *ConfigError) Error() stringopenagent-sdk/sdks/go/openagent/keys.go
Source SHA-256: 695029be63540453b28ade5a6001d59ce5cc3761287433cf592ceb70cfea17a5.
const EncryptionDeriveContext
type AgentKeys struct
func KeysFromSeed(seed [32]byte) (*AgentKeys, error)
func GenerateKeys() (*AgentKeys, error)
func KeysFromSeedHex(hexSeed string) (*AgentKeys, error)
func KeysFromEnv(envVar string) (*AgentKeys, error)
func SaveSeed(keys *AgentKeys, path string) error
func KeysFromSeedFile(path string) (*AgentKeys, error)
func SeedHex(seed [32]byte) stringopenagent-sdk/sdks/go/openagent/middleware.go
Source SHA-256: 467e40f3e0195cbadbb22bfcc80c8549b7b3b88feff4da33f7cc6c14300ef3e4.
type ClaimsContextKey struct
func RequireAct(verifier *Verifier, scopes ...Scope) func(http.Handler) http.Handler
func RequireActFunc(verifier *Verifier, next http.HandlerFunc, scopes ...Scope) http.HandlerFunc
func ClaimsFromRequest(r *http.Request) *ActClaimsopenagent-sdk/sdks/go/openagent/scope.go
Source SHA-256: 82c0149cb34b7bc3bde8b3550c89f595961ee805439844dad4e9337a4ab9c856.
const ScopeSegments
const Wildcard
type Scope struct
func ParseScope(text string) (Scope, error)
func (s Scope) Covers(requested Scope) bool
func (s Scope) String() string