How do I integrate MyShape identity verification into my app?

MyShape provides a read-only API for querying protocol node identity and network statistics. The motion-signature verification runs entirely on-device via the MyShape WASM engine. Integration requires five lines of code: import the SDK, initialize with your API key, call the verification endpoint, receive the ZK proof, and validate on your backend. Full SDK documentation and API reference are available on this page.

What programming languages does the MyShape SDK support?

The MyShape SDK currently supports TypeScript/JavaScript (Node.js and browser) as the primary target. The core verification engine is compiled to WASM, making it portable to any language that can execute WebAssembly — including Python (via wasmtime), Rust, Go, and Java. REST API endpoints are language-agnostic.

Is the MyShape Protocol open source?

Yes. The core protocol specification, the WASM verification engine, and the SDK are open source under the MyShape Protocol License. The SST topology, motion vector format, and PES algorithm are fully documented in the technical specification. The reference implementation is available on GitHub at github.com/myshapeprotocol.

How do I verify a ZK-Presence proof on my backend?

Each ZK-Presence proof (~250 bytes) can be verified in under 10ms using the verification key published in the protocol specification. The proof asserts: 'PES > threshold AND motion was captured within the last 5 seconds AND the motion exhibits biological entropy characteristics.' Your backend receives the proof, runs the verification algorithm, and receives a binary valid/invalid response — no motion data, no biometric data, no PII.

Dev Nodes are live. Deploy a protocol anchor in 60 seconds. No wallet. No invite.Get Started ↓

DEVELOPER_HUB // V1.0

Build with Presence

Integrate sovereign identity verification into any application. Five lines of code. Zero data stored. Real human presence.

◈ Try Live Demo →GitHub →Discord #api #agents →

// QUICK_START (5 MIN)

01Get the SDK30 sec

git clone https://github.com/myshapeprotocol/sdk.git
cd sdk && npm install

Zero dependencies. TypeScript native. Works with Node.js 18+.

02Capture Motion Frames2 min

import { Pose } from "@mediapipe/pose";

const pose = new Pose({ locateFile: (f) => ... });
pose.onResults((results) => {
  const frames = results.poseLandmarks;
  // Each frame: 33 joints × { x, y, z, visibility }
});

Use any MediaPipe-compatible camera. We recommend Firefox for WebGL stability.

03Verify Presence1 min

// 5 lines to integrate Presence
import MyShape from "@/sdk";

const frames = [...]; // MediaPipe pose landmarks
const timestamps = [...];

const receipt = MyShape.requestPresence(frames, timestamps);
const isValid = MyShape.verifyReceipt(receipt);
// Done. Your app now has presence verification.

That's it. Your app now rejects AI-generated motion at the protocol level.

04See It Working30 sec

◈ Try Live Demo →▼ Skip to Playground

// REST_API (CURL_READY)

CHECK_PROTOCOL_HEALTH

curl https://www.myshape.com/api/health

→ RESPONSE

{ "status": "healthy", "services": { "supabase": { "ok": true }, "wasm": { "ok": true } } }

GET_NETWORK_STATUS

curl https://www.myshape.com/api/nodes/status

→ RESPONSE

{ "total_nodes": 42, "genesis_nodes": 23, "genesis_remaining": 77, "active_nodes": 12 }

LOOKUP_NODE

curl https://www.myshape.com/api/identity?email=user@example.com

→ RESPONSE

{ "handle": "SIG_XXXX", "status": "GENESIS_NODE", "pes": 0.87 }

Full OpenAPI spec: openapi.json · Complete reference: /docs →

// SDK_REFERENCE (§8)

Module	Method	Returns	Description
Presence	generatePresenceProof(frames, timestamps, opts?)	PresenceProofResult	Generate PoP + MP + EP + ZKP from MediaPipe frames
Presence	getEntropyScore(frames, timestamps)	number \| null	Real-time PES for live UI feedback
Presence	requestPresence(frames, timestamps)	PresenceReceipt	Full flow: proof → submit → receipt
Proof	verifyLocalProof(proof, opts?)	VerificationResult	Verify ZKP locally with 5 checks
Proof	aggregateProofs(proofs[])	AggregatedProof	Recursive proof aggregation over time windows
Proof	revokeDevice(reason?)	RevocationReceipt	Rotate device salt and revoke old identity
Verification	verifyPresenceProof(zkp, opts?)	VerificationResult	Full 6-rule verification (§9.4)
Verification	verifyPresenceReceipt(receipt)	boolean	Lightweight app-layer verification

// PROTOCOL_ENGINES

PES Engine

engine/presence-entropy.ts

4-dimensional entropy scoring

Proof System

engine/proof-system.ts

PoP + MP + EP → ZK-Presence

SST Mapper

engine/skeleton-topology.ts

MediaPipe 33-pt → SST 18-pt

Threat Assessment

engine/threat-assessment.ts

8 attack signatures, corroboration logic

Protocol Validator

engine/protocol-validator.ts

6 verification rules §9.4

Local Identity

engine/local-identity.ts

Device salt, key derivation, session

Presence Stream

engine/presence-stream.ts

Aggregation, multi-device, PSS

Unforgeability

engine/unforgeability.ts

Entropy gap theorem, security horizon

// CODE_EXAMPLES

Basic Presence Verification

import MyShape from "@/sdk";

// MediaPipe pose landmarks from camera
const frames = [...];
const timestamps = [...];

const receipt = MyShape.requestPresence(frames, timestamps);
// → { zkp_hash, pes: 0.72, timestamp, session_id }

const valid = MyShape.verifyReceipt(receipt);
// → true if human presence confirmed

Threat Assessment

import { assessThreat } from "@/engine/threat-assessment";
import { computeFullPES } from "@/engine/presence-entropy";

const { pes, components } = computeFullPES(sstFrames, timestamps);
const threat = assessThreat(pes, components);

if (threat.overallVerdict === "human") {
  // Allow access. Real human confirmed.
} else if (threat.overallVerdict === "suspicious") {
  // Request additional verification
} else {
  // Block. Likely synthetic.
}

// ONLINE_PLAYGROUND

Developer PlaygroundNo setup · No camera · Browser only

PLAYGROUND_ENGINE_V1

// YOUR_CODE

// 1. Pre-recorded frames from a real human scan
import { computeFullPES } from "@/engine/presence-entropy";
import { assessThreat } from "@/engine/threat-assessment";

// 2. Run PES + Threat Assessment
const { pes, components } = computeFullPES(sampleFrames, timestamps);
const threat = assessThreat(pes, components);

// 3. Check result
if (threat.overallVerdict === "human") {
// ✓ Real human presence confirmed
}

// OUTPUT

Press "Run Verification" to see output

Sample data: 30s scan · 180 frames · Real human · MediaPipe 33-pt → SST 18-ptTry with YOUR motion →

// DEVELOPER_COHORT

Early Ecosystem

MyShape SDK is in active development. Join the Developer Cohort to get early access, influence the API design, and build the first wave of presence-verified applications.

◆Early SDK access before public release

◆Direct line to protocol architects

◆Your app featured on myshape.com/build

◆Genesis Developer badge (on-chain record)

Star on GitHub →Apply for Genesis Node →

LIVE_VERIFICATION // v0.1

Presence Verification Dashboard

Runtime engine output from myshape-demo CLI. Motion Signature Engine (128-dim, 4 feature groups) + Multi-Factor Scorer. All scores computed by the Rust core engine compiled to native binary.

HUMAN—AI DIVERGENCE

0.0000

Presence Gap

The irreducible distance between genuine biological motion and the best AI-generated forgery. This gap exists because AI models cannot replicate the physics of the human nervous system.

GENUINE HUMAN

0.0000

PRESENCE CONFIRMED

Real-time biological motion · 8–12 Hz tremor · 1/f jerk spectrum

Motion

0.970

Device

1.000

Context

1.000

Threshold0.75

AI FORGERY

0.0000

PRESENCE DENIED

GPT-5 / DeepSeek synthetic motion · over-smoothed dynamics

Motion

0.310

Device

1.000

Context

1.000

Threshold0.75

IMPOSTOR

0.0000

HARD GATE · DEVICE MISMATCH

Different human entity · different device · kinematic mismatch

Motion

0.955

Device

0.000

Context

0.000

Threshold0.75

AI REJECTION ROOT CAUSE ANALYSIS

The AI forgery failed verification because the Motion Signature Engine detected structural deficiencies across four independent dimensions. These are not temporary AI limitations — they are consequences of how neural network architectures model motion.

// REST_API

GET/api/identity?email=...Look up a node by email

GET/api/nodes/countTotal protocol node counts

POST/api/nodes/handshakeRegister a new protocol node → returns node_token + node_handleTry it →

// RESPONSE_FORMAT

GET /api/identity?email=protocol@myshape.com

{
  "found": true,
  "email": "protocol@myshape.com",
  "node_handle": null,
  "status": "GENESIS_NODE",
  "registered_at": "2026-06-22T09:12:01.329Z"
}

GET /api/nodes/count

{
  "total": 17,
  "humans": 8,
  "agents": 3,
  "genesis_nodes": 4
}

POST /api/nodes/handshake → Live Demo

// Request
{ "email": "entity@protocol.io", "origin_domain": "myshape.com" }

// Response (201)
{
  "node_token": "ms_a1b2c3d4e5f6...",
  "node_handle": "SIG_4F7A2C1B",
  "stage": "GENESIS_NODE_INITIALIZED"
}

// PROTOCOL_PATHS

◆DEV_NODEYOU_ARE_HERE

PurposeProtocol Access — Build & Deploy

Setup60 seconds. No wallet. No invite.

ScopeAPI / Agent Layer — productivity & integration

StatusRenewable. Sandbox-first. Scaleable.

PathDeploy → Call API → Build Agents

◈GENESIS_NODEINVITE_ONLY

PurposeSovereign Identity — Governance & Trust

Setup40-second kinetic ceremony + OTP verification

ScopeIdentity Layer — protocol root & entropy anchor

StatusPermanent. Immutable. Never offered again.

PathVerify Presence → Claim Slot → Anchor Identity

Enter Genesis →

Protocol_Boundary

// DEPLOY_ANCHOR_NOW

DEV_SANDBOX // 60_SEC_TO_PROTOCOL_ANCHORNO_WALLET · NO_INVITE · NO_GENESIS

Choose a handle. Or leave it blank — we'll generate one.
This deploys a Protocol Anchor. Not an account. Not a user. A cryptographic node in the identity mesh.

SYNCHRONIZING

Dev Nodes are live. Deploy a protocol anchor in 60 seconds. No wallet. No invite.Get Started ↓

DEVELOPER_HUB // V1.0

Build with Presence

Integrate sovereign identity verification into any application. Five lines of code. Zero data stored. Real human presence.

◈ Try Live Demo →GitHub →Discord #api #agents →

// QUICK_START (5 MIN)

01Get the SDK30 sec

git clone https://github.com/myshapeprotocol/sdk.git
cd sdk && npm install

Zero dependencies. TypeScript native. Works with Node.js 18+.

02Capture Motion Frames2 min

import { Pose } from "@mediapipe/pose";

const pose = new Pose({ locateFile: (f) => ... });
pose.onResults((results) => {
  const frames = results.poseLandmarks;
  // Each frame: 33 joints × { x, y, z, visibility }
});

Use any MediaPipe-compatible camera. We recommend Firefox for WebGL stability.

03Verify Presence1 min

// 5 lines to integrate Presence
import MyShape from "@/sdk";

const frames = [...]; // MediaPipe pose landmarks
const timestamps = [...];

const receipt = MyShape.requestPresence(frames, timestamps);
const isValid = MyShape.verifyReceipt(receipt);
// Done. Your app now has presence verification.

That's it. Your app now rejects AI-generated motion at the protocol level.

04See It Working30 sec

◈ Try Live Demo →▼ Skip to Playground

// REST_API (CURL_READY)

CHECK_PROTOCOL_HEALTH

curl https://www.myshape.com/api/health

→ RESPONSE

{ "status": "healthy", "services": { "supabase": { "ok": true }, "wasm": { "ok": true } } }

GET_NETWORK_STATUS

curl https://www.myshape.com/api/nodes/status

→ RESPONSE

{ "total_nodes": 42, "genesis_nodes": 23, "genesis_remaining": 77, "active_nodes": 12 }

LOOKUP_NODE

curl https://www.myshape.com/api/identity?email=user@example.com

→ RESPONSE

{ "handle": "SIG_XXXX", "status": "GENESIS_NODE", "pes": 0.87 }

Full OpenAPI spec: openapi.json · Complete reference: /docs →

// SDK_REFERENCE (§8)

Module	Method	Returns	Description
Presence	generatePresenceProof(frames, timestamps, opts?)	PresenceProofResult	Generate PoP + MP + EP + ZKP from MediaPipe frames
Presence	getEntropyScore(frames, timestamps)	number \| null	Real-time PES for live UI feedback
Presence	requestPresence(frames, timestamps)	PresenceReceipt	Full flow: proof → submit → receipt
Proof	verifyLocalProof(proof, opts?)	VerificationResult	Verify ZKP locally with 5 checks
Proof	aggregateProofs(proofs[])	AggregatedProof	Recursive proof aggregation over time windows
Proof	revokeDevice(reason?)	RevocationReceipt	Rotate device salt and revoke old identity
Verification	verifyPresenceProof(zkp, opts?)	VerificationResult	Full 6-rule verification (§9.4)
Verification	verifyPresenceReceipt(receipt)	boolean	Lightweight app-layer verification

// PROTOCOL_ENGINES

PES Engine

engine/presence-entropy.ts

4-dimensional entropy scoring

Proof System

engine/proof-system.ts

PoP + MP + EP → ZK-Presence

SST Mapper

engine/skeleton-topology.ts

MediaPipe 33-pt → SST 18-pt

Threat Assessment

engine/threat-assessment.ts

8 attack signatures, corroboration logic

Protocol Validator

engine/protocol-validator.ts

6 verification rules §9.4

Local Identity

engine/local-identity.ts

Device salt, key derivation, session

Presence Stream

engine/presence-stream.ts

Aggregation, multi-device, PSS

Unforgeability

engine/unforgeability.ts

Entropy gap theorem, security horizon

// CODE_EXAMPLES

Basic Presence Verification

import MyShape from "@/sdk";

// MediaPipe pose landmarks from camera
const frames = [...];
const timestamps = [...];

const receipt = MyShape.requestPresence(frames, timestamps);
// → { zkp_hash, pes: 0.72, timestamp, session_id }

const valid = MyShape.verifyReceipt(receipt);
// → true if human presence confirmed

Threat Assessment

import { assessThreat } from "@/engine/threat-assessment";
import { computeFullPES } from "@/engine/presence-entropy";

const { pes, components } = computeFullPES(sstFrames, timestamps);
const threat = assessThreat(pes, components);

if (threat.overallVerdict === "human") {
  // Allow access. Real human confirmed.
} else if (threat.overallVerdict === "suspicious") {
  // Request additional verification
} else {
  // Block. Likely synthetic.
}

// ONLINE_PLAYGROUND

Developer PlaygroundNo setup · No camera · Browser only

PLAYGROUND_ENGINE_V1

// YOUR_CODE

// OUTPUT

Press "Run Verification" to see output

Sample data: 30s scan · 180 frames · Real human · MediaPipe 33-pt → SST 18-ptTry with YOUR motion →

// DEVELOPER_COHORT

Early Ecosystem

MyShape SDK is in active development. Join the Developer Cohort to get early access, influence the API design, and build the first wave of presence-verified applications.

◆Early SDK access before public release

◆Direct line to protocol architects

◆Your app featured on myshape.com/build

◆Genesis Developer badge (on-chain record)

Star on GitHub →Apply for Genesis Node →

LIVE_VERIFICATION // v0.1

Presence Verification Dashboard

Runtime engine output from myshape-demo CLI. Motion Signature Engine (128-dim, 4 feature groups) + Multi-Factor Scorer. All scores computed by the Rust core engine compiled to native binary.

HUMAN—AI DIVERGENCE

0.0000

Presence Gap

The irreducible distance between genuine biological motion and the best AI-generated forgery. This gap exists because AI models cannot replicate the physics of the human nervous system.

GENUINE HUMAN

0.0000

PRESENCE CONFIRMED

Real-time biological motion · 8–12 Hz tremor · 1/f jerk spectrum

Motion

0.970

Device

1.000

Context

1.000

Threshold0.75

AI FORGERY

0.0000

PRESENCE DENIED

GPT-5 / DeepSeek synthetic motion · over-smoothed dynamics

Motion

0.310

Device

1.000

Context

1.000

Threshold0.75

IMPOSTOR

0.0000

HARD GATE · DEVICE MISMATCH

Different human entity · different device · kinematic mismatch

Motion

0.955

Device

0.000

Context

0.000

Threshold0.75

AI REJECTION ROOT CAUSE ANALYSIS

// REST_API

GET/api/identity?email=...Look up a node by email

GET/api/nodes/countTotal protocol node counts

POST/api/nodes/handshakeRegister a new protocol node → returns node_token + node_handleTry it →

// RESPONSE_FORMAT

GET /api/identity?email=protocol@myshape.com

{
  "found": true,
  "email": "protocol@myshape.com",
  "node_handle": null,
  "status": "GENESIS_NODE",
  "registered_at": "2026-06-22T09:12:01.329Z"
}

GET /api/nodes/count

{
  "total": 17,
  "humans": 8,
  "agents": 3,
  "genesis_nodes": 4
}

POST /api/nodes/handshake → Live Demo

// Request
{ "email": "entity@protocol.io", "origin_domain": "myshape.com" }

// Response (201)
{
  "node_token": "ms_a1b2c3d4e5f6...",
  "node_handle": "SIG_4F7A2C1B",
  "stage": "GENESIS_NODE_INITIALIZED"
}

// PROTOCOL_PATHS

◆DEV_NODEYOU_ARE_HERE

PurposeProtocol Access — Build & Deploy

Setup60 seconds. No wallet. No invite.

ScopeAPI / Agent Layer — productivity & integration

StatusRenewable. Sandbox-first. Scaleable.

PathDeploy → Call API → Build Agents

◈GENESIS_NODEINVITE_ONLY

PurposeSovereign Identity — Governance & Trust

Setup40-second kinetic ceremony + OTP verification

ScopeIdentity Layer — protocol root & entropy anchor

StatusPermanent. Immutable. Never offered again.

PathVerify Presence → Claim Slot → Anchor Identity

Enter Genesis →

Protocol_Boundary

// DEPLOY_ANCHOR_NOW

DEV_SANDBOX // 60_SEC_TO_PROTOCOL_ANCHORNO_WALLET · NO_INVITE · NO_GENESIS

Choose a handle. Or leave it blank — we'll generate one.
This deploys a Protocol Anchor. Not an account. Not a user. A cryptographic node in the identity mesh.