app.gainforest.link.evm

Documentation

A verifiable link between an ATProto DID and an EVM wallet address, with platform attestation. The user proves wallet ownership via EIP-712 signature, and the platform co-signs to attest the linking occurred through a trusted service.

main record

Record Key any Any valid record key

Properties

address string Required

EVM wallet address (0x-prefixed, checksummed).

maxLength: 42 bytesminLength: 42 bytes

createdAt string datetime Required

Client-declared timestamp when this record was originally created.

name string Optional

Optional user-defined name for this wallet link (e.g. 'Personal Wallet', 'Project Treasury'). Helps users identify which wallet this record represents when they have multiple linked wallets.

maxLength: 100 bytes

platformAttestation union Required

Platform's co-signature attesting that this link was created through the trusted service. Open union to support future attestation methods.

Known types:

#eip712PlatformAttestation

userProof union Required

User's cryptographic proof of wallet ownership. Open union to support future signature methods (ERC-1271, ERC-6492).

Known types:

#eip712Proof

View raw schema

{
  "key": "any",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "address",
      "userProof",
      "platformAttestation",
      "createdAt"
    ],
    "properties": {
      "name": {
        "type": "string",
        "maxLength": 100,
        "description": "Optional user-defined name for this wallet link (e.g. 'Personal Wallet', 'Project Treasury'). Helps users identify which wallet this record represents when they have multiple linked wallets."
      },
      "address": {
        "type": "string",
        "maxLength": 42,
        "minLength": 42,
        "description": "EVM wallet address (0x-prefixed, checksummed)."
      },
      "createdAt": {
        "type": "string",
        "format": "datetime",
        "description": "Client-declared timestamp when this record was originally created."
      },
      "userProof": {
        "refs": [
          "#eip712Proof"
        ],
        "type": "union",
        "description": "User's cryptographic proof of wallet ownership. Open union to support future signature methods (ERC-1271, ERC-6492)."
      },
      "platformAttestation": {
        "refs": [
          "#eip712PlatformAttestation"
        ],
        "type": "union",
        "description": "Platform's co-signature attesting that this link was created through the trusted service. Open union to support future attestation methods."
      }
    }
  },
  "description": "A verifiable link between an ATProto DID and an EVM wallet address, with platform attestation. The user proves wallet ownership via EIP-712 signature, and the platform co-signs to attest the linking occurred through a trusted service."
}

eip712Message object

The EIP-712 typed data message signed by the user's wallet.

Properties

chainId string Required

EVM chain ID as string (bigint serialized). The EIP-712 domain is chain-specific; verifiers should treat this attestation as valid only for the specified chain.

maxLength: 78 bytesminLength: 1 bytes

did string did Required

The ATProto DID being linked to the EVM address.

maxLength: 256 bytes

evmAddress string Required

The EVM wallet address (must match the top-level address field).

maxLength: 42 bytesminLength: 42 bytes

nonce string Required

Replay-protection nonce (bigint serialized).

maxLength: 78 bytesminLength: 1 bytes

timestamp string Required

Unix timestamp when the attestation was created (bigint serialized).

maxLength: 78 bytesminLength: 1 bytes

View raw schema

{
  "type": "object",
  "required": [
    "did",
    "evmAddress",
    "chainId",
    "timestamp",
    "nonce"
  ],
  "properties": {
    "did": {
      "type": "string",
      "format": "did",
      "maxLength": 256,
      "description": "The ATProto DID being linked to the EVM address."
    },
    "nonce": {
      "type": "string",
      "maxLength": 78,
      "minLength": 1,
      "description": "Replay-protection nonce (bigint serialized)."
    },
    "chainId": {
      "type": "string",
      "maxLength": 78,
      "minLength": 1,
      "description": "EVM chain ID as string (bigint serialized). The EIP-712 domain is chain-specific; verifiers should treat this attestation as valid only for the specified chain."
    },
    "timestamp": {
      "type": "string",
      "maxLength": 78,
      "minLength": 1,
      "description": "Unix timestamp when the attestation was created (bigint serialized)."
    },
    "evmAddress": {
      "type": "string",
      "maxLength": 42,
      "minLength": 42,
      "description": "The EVM wallet address (must match the top-level address field)."
    }
  },
  "description": "The EIP-712 typed data message signed by the user's wallet."
}

eip712PlatformAttestation object

Platform's EIP-712 attestation that this DID-wallet link was created through a trusted service. The platform signs over the user's signature to bind its attestation to the specific linking event.

Properties

platformAddress string Required

The platform's signing wallet address (0x-prefixed). Verifiers should check this against known/trusted platform addresses.

maxLength: 42 bytesminLength: 42 bytes

signature string Required

Platform's ECDSA signature over the signedData (hex-encoded with 0x prefix, 64 or 65 bytes).

maxLength: 132 bytesminLength: 130 bytes

signedData string Required

The user's signature that the platform signed over (hex-encoded with 0x prefix). This binds the platform attestation to the specific user proof.

maxLength: 132 bytesminLength: 130 bytes

View raw schema

{
  "type": "object",
  "required": [
    "signature",
    "platformAddress",
    "signedData"
  ],
  "properties": {
    "signature": {
      "type": "string",
      "maxLength": 132,
      "minLength": 130,
      "description": "Platform's ECDSA signature over the signedData (hex-encoded with 0x prefix, 64 or 65 bytes)."
    },
    "signedData": {
      "type": "string",
      "maxLength": 132,
      "minLength": 130,
      "description": "The user's signature that the platform signed over (hex-encoded with 0x prefix). This binds the platform attestation to the specific user proof."
    },
    "platformAddress": {
      "type": "string",
      "maxLength": 42,
      "minLength": 42,
      "description": "The platform's signing wallet address (0x-prefixed). Verifiers should check this against known/trusted platform addresses."
    }
  },
  "description": "Platform's EIP-712 attestation that this DID-wallet link was created through a trusted service. The platform signs over the user's signature to bind its attestation to the specific linking event."
}

eip712Proof object

EOA wallet ownership proof via EIP-712 typed data signature.

Properties

message ref #eip712Message Required

The EIP-712 structured message fields that were signed.

signature string Required

User's ECDSA signature over the EIP-712 hash (hex-encoded with 0x prefix, 64 or 65 bytes).

maxLength: 132 bytesminLength: 130 bytes

View raw schema

{
  "type": "object",
  "required": [
    "signature",
    "message"
  ],
  "properties": {
    "message": {
      "ref": "#eip712Message",
      "type": "ref",
      "description": "The EIP-712 structured message fields that were signed."
    },
    "signature": {
      "type": "string",
      "maxLength": 132,
      "minLength": 130,
      "description": "User's ECDSA signature over the EIP-712 hash (hex-encoded with 0x prefix, 64 or 65 bytes)."
    }
  },
  "description": "EOA wallet ownership proof via EIP-712 typed data signature."
}