Overview

Stores the wallet's acknowledgment that it viewed OpenCover's terms before selecting COVERED in the strategy wizard. SignedRequest; action opencover_terms (statement Authorize opencover_terms). Unlike the platform ToS, the FULL signed SIWE message and the raw signature are PERSISTED as proof (a third party's terms), keyed one-row-per-wallet with last-write-wins semantics. The addr is in the PATH; the recovered wallet MUST equal it or the call is a 403 owner_mismatch. The signed terms_url binds which terms version was acknowledged and is echoed back. This ack is ENFORCED at covered strategy create (403 covered_terms_required), not merely client-gated.

Endpoint

POST https://earn-api.quicknode.dev/functions/v1/api/v1/wallets/{addr}/opencover-terms

Authorization

Include the published apikey header and a valid Sign-In with Ethereum (SIWE) proof in the request body. The SIWE message binds the wallet to this action, payload, and request path.

Parameters

Parameter	Location	Type	Required	Description
addr	path	string	Yes	Wallet address (`0x` + 40 hex).

Request body

The signed payload binds the literal terms_url (the OpenCover terms version acknowledged). The full SIWE message and raw signature are persisted as proof.

Field	Type	Required	Description
siwe	object	Yes	A Sign-In-With-Ethereum proof binding the wallet to (action, payload, issuedAt, expirationTime).
terms_url	string	No	The OpenCover terms URL being acknowledged; bound into the signature and echoed back.

Example request

curl --request POST \
  --url 'https://earn-api.quicknode.dev/functions/v1/api/v1/wallets/0x1234567890abcdef1234567890abcdef12345678/opencover-terms' \
  --header 'Accept: application/json' \
  --header 'apikey: <EARN_PUBLIC_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "terms_url": "https://opencover.com/terms",
  "siwe": {
    "message": "earn.quicknode.com wants you to sign in with your Ethereum account:\n0x1234...\n\nAuthorize opencover_terms\n\nURI: https://earn.quicknode.com\nVersion: 1\nChain ID: 8453\nNonce: 5c6d...\nIssued At: 2026-07-07T18:00:00.000Z\nExpiration Time: 2026-07-07T18:05:00.000Z\nResources:\n- sha256:<hex>\n- path:/wallets/0x1234.../opencover-terms",
    "signature": "0xabcd..."
  }
}'

Response

Field	Type	Required	Description
ok	boolean	Yes	Always true on a 2xx.
address	string	Yes	Lowercased wallet address.
opencover_terms_accepted	boolean	Yes	Always true after recording.
terms_url	string	No	Echo of the signed `terms_url` (absent when the caller sent none).

Example response

{
	"ok": true,
	"address": "0x1234567890abcdef1234567890abcdef12345678",
	"opencover_terms_accepted": true,
	"terms_url": "https://opencover.com/terms"
}

HTTP responses

Status	Description
200	The recorded acknowledgment.
400	Malformed request or SIWE block. `code` is one of: `invalid_request`, `siwe_missing` (no `siwe` block), `siwe_shape` (message/signature not strings), `siwe_parse` (message does not match the documented line format).
401	SIWE verification failed. `code` is one of: `siwe_domain` (message domain not allowlisted), `siwe_action` (statement/action mismatch), `siwe_stale` (expired or validity window out of bounds), `siwe_payload` (payload hash or resource mismatch — canonicalization drift, a re-serialized body, or a `- path:` entry that does not match the request path), `siwe_chain` (bad chain id), `siwe_recover` (signature does not match the claimed address), `siwe_replay` (nonce already used — sign a fresh request).
403	The signing wallet does not match the `{addr}` in the path. A wallet may only write its own preferences / ToS state.
429	Rate limit exceeded. `Retry-After` (seconds) tells you when to retry. Reads, feedback, and push writes are keyed per IP; create/update/delete are keyed per wallet+IP; deposit/withdraw/claim calldata is keyed per strategy+IP.
500	Internal server error.
503	Signature verification could not reach the chain to validate a contract (ERC-1271) wallet. Transient — retry. Only occurs for smart-wallet signers.

OpenAPI source

This page is based on operation recordOpencoverTerms in the Earn OpenAPI 3.1 specification.