Installation

Fidemark ships three first-party SDKs that share the same surface, the same EAS schemas, and the same error taxonomy. Pick whichever language fits your stack.

Install

TypeScript

npm install @fidemark/sdk ethers

Peer requirements:

• Node.js 20 or newer.
• An ethers v6 signer or a private key for write operations. Read-only verification does not require a signer.
• An RPC endpoint for Base or Base Sepolia. The SDK ships sensible defaults; override them via provider in the constructor.

import {
  Fidemark,
  getNetwork,
  hashContent,
  FidemarkError,
} from "@fidemark/sdk";

Python

pip install fidemark

Peer requirements:

• Python 3.11 or newer.
• A private key (hex-encoded) for write operations. Read-only verification works with provider_url alone.
• An HTTPS RPC endpoint for Base or Base Sepolia.

from fidemark import (
    Fidemark,
    AttestHumanInput,
    hash_content,
    get_network,
    FidemarkError,
)

Go

go get github.com/fidemark/sdk-go/fidemark

Peer requirements:

• Go 1.23 or newer.
• A hex-encoded private key for write operations.
• An HTTPS RPC endpoint for Base or Base Sepolia.

import "github.com/fidemark/sdk-go/fidemark"

Surface parity

Every method documented in this section exists in all three SDKs. Naming follows each language’s conventions (attestHuman in TypeScript, attest_human in Python, AttestHuman in Go) but the inputs, outputs, and error codes are identical.

Behavior	TypeScript	Python	Go
Construct client	new Fidemark(config)	Fidemark(...)	fidemark.New(Config{...})
Attest Human Proof	attestHuman	attest_human	AttestHuman
Attest AI Proof	attestAI	attest_ai	AttestAI
Off-chain envelope	attestHumanOffchain	attest_human_offchain	AttestHumanOffchain
Publish off-chain on-chain	publishOffchain	publish_offchain	PublishOffchain
Multi-party	attestMultiParty	attest_multi_party	AttestMultiParty
PoP-verified (World ID)	attestHumanWithPoP	attest_human_with_pop	AttestHumanWithPoP
Verify by UID	verify	verify	Verify
Verify by content hash	verifyByHash	verify_by_hash	VerifyByHash
Walk refUID chain	verifyChain	verify_chain	VerifyChain
Revoke	revoke	revoke	Revoke
GraphQL indexer fallback	indexer config option	indexer config option	Indexer config option

The SDK pages that follow show the same call in each language via tabs. Pick once, your choice persists across pages.