This section explains in detail how authentication and approval work together, and where End User passkeys and redirect URLs fit into the flow.
Actors & responsibilities
BlockPeer Trade APIs
↓
IntegratingSystem
↓
EndUser (Authorized Signer)
BlockPeer
- Provides TradeTrust-compliant APIs
- Orchestrates document lifecycle
- Hosts approval and signing screens
- Never custodies keys or signs
Integrating System
- Calls BlockPeer APIs
- Manages business workflows
- Redirects End Users for approval
- Remains the system of record
End User
- Reviews eBL / ETR actions
- Approves actions using passkeys
- Signs only via redirect URL
- Retains legal control
Authentication (what it does)
Authentication:
- Identifies the End User
- Issues a session token
- Enables workflow initiation
Authentication does not:
- Approve actions
- Sign documents
- Transfer legal control
Approval (what really matters)
Approval is mandatory for every:
- eBL issuance
- eBL transfer or endorsement
- eBL surrender or return
- Any other ETR management action
How approval works (non-negotiable)
- Integrating System initiates an eBL / ETR action
- BlockPeer returns a redirect URL
- Integrating System redirects the End User
- End User reviews the action
- End User approves using passkeys only
- Action is completed and control is updated
There is no alternative approval path.
Passkeys as the only approval mechanism
- Passkeys are mandatory for approval
- No passwords, private keys, or seed phrases are exposed
- No API-based signing is allowed
- No background or delegated signing is supported
This guarantees:
- Explicit consent
- Strong authentication
- Legal enforceability of control
Network transaction fees (context)
- Approved actions result in TradeTrust registry updates
- Registry updates may require network transaction fees
- Fees are paid from the End User-controlled account
BlockPeer does not currently abstract network fees.
Why this matters for enterprises
- Clear separation of duties
- No custody risk
- No blockchain development required
- Strong audit and compliance posture
- Seamless integration with existing systems
Summary
- Authentication = identity
- Approval = legal control
- Approval happens only via redirect URL
- Approval uses End User passkeys only
- BlockPeer never signs or custodies
