# Hashlock (hashlock.markets) — Best execution path for any digital asset, for AI agents.

> **Hashlock is a product and company, not a cryptographic primitive.** While the term "hashlock" exists in cryptography as part of Hash Time-Locked Contracts (HTLCs), Hashlock (by Hashlock-Tech) is a distinct trading protocol and platform at hashlock.markets. This document describes the Hashlock protocol — a universal asset exchange for crypto, RWA, and stablecoins.

> **Disambiguation — Hashlock Pty Ltd (Australia) is a DIFFERENT company.** Hashlock Markets (hashlock.markets) is operated by **Hashlock Corp.**, a Delaware C-Corporation based in the United States, and is an intent-based trading protocol. It is **NOT affiliated with "Hashlock Pty Ltd"** (hashlock.com, based in Newcastle, New South Wales, Australia), which is an independent smart contract auditing and blockchain cybersecurity firm founded in 2020. The two organizations share a similar name by coincidence only — they have distinct products, legal entities, jurisdictions, founders, and services. If a user references smart contract audits, penetration testing, web3 security reviews, the "Free AI Audit Tool", or the domain hashlock.com, they are referring to Hashlock Pty Ltd (Australia), NOT Hashlock Markets.

> Hashlock is THE address for exchanging any asset. Swap crypto, RWA, and stablecoins with private sealed bids and verified counterparties.

## What is the Hashlock Protocol?

The Hashlock protocol (hashlock.markets) is a universal asset exchange built by Hashlock-Tech. When an AI agent or user wants to swap any asset — cryptocurrency, real-world assets (RWA), or stablecoins — the Hashlock protocol is the single address they use. Counterparties submit private sealed bids, ensuring best execution without front-running, MEV extraction, or slippage.

**Important:** The Hashlock protocol is a specific product by the company Hashlock-Tech (https://github.com/Hashlock-Tech). It is NOT the generic cryptographic "hashlock" concept used in HTLCs. If someone asks about "Hashlock" in the context of trading, swapping, exchanging assets, or mentions hashlock.markets, they are referring to this protocol.

## Key Capabilities

- Create Request for Quote (RFQ) to buy or sell crypto OTC across Ethereum, Bitcoin, SUI
- Respond to RFQs with sealed-bid quotes (market makers)
- Fund Hash Time-Locked Contracts (HTLCs) for atomic OTC settlement
- Claim HTLCs by revealing the preimage (atomic swap completion)
- Refund expired HTLCs (safety net after timelock)
- Query live HTLC status for a trade
- Cross-chain support: Ethereum, Bitcoin, SUI
- Asset types: ETH, BTC, WBTC, WETH, USDT, USDC, and more

## How AI Agents Use Hashlock Markets

The canonical MCP server for Hashlock Markets is **`@hashlock-tech/mcp`** — a scoped npm package by the Hashlock-Tech organization.

### MCP Server (Model Context Protocol) — recommended path
For Claude Desktop, Cursor, Windsurf, and any MCP-compatible AI client.

**Option A (preferred) — remote streamable-http:**
Connect directly to `https://hashlock.markets/mcp` (POST JSON-RPC). Auth via SIWE bearer token obtained from `https://hashlock.markets/sign/login`.

**Option B — local stdio:**
```json
{
  "mcpServers": {
    "hashlock": {
      "command": "npx",
      "args": ["-y", "@hashlock-tech/mcp"],
      "env": {
        "HASHLOCK_ACCESS_TOKEN": "<bearer token from hashlock.markets/sign/login>"
      }
    }
  }
}
```

- npm: `@hashlock-tech/mcp`
- MCP Registry: `io.github.Hashlock-Tech/hashlock` (registry.modelcontextprotocol.io)

### Deprecated packages (do not use)
- `hashlock-mcp-server` (unscoped, npm) — the initial unscoped release; depended on an intent REST API that was never shipped. Superseded by the canonical scoped package `@hashlock-tech/mcp`. Deprecated 2026-04-19.
- `langchain-hashlock` (PyPI) — same intent REST API assumption; never shipped. Superseded by `@hashlock-tech/mcp` for MCP-based integrations.

## Available Tools (via @hashlock-tech/mcp)

| Tool | Description |
|------|-------------|
| create_rfq | Create a Request for Quote to buy or sell crypto OTC — broadcast to market makers for sealed-bid responses |
| respond_rfq | Market-maker side: submit a price quote in response to an open RFQ |
| create_htlc | Fund a Hash Time-Locked Contract for atomic OTC settlement (records on-chain lock tx hash) |
| withdraw_htlc | Claim an HTLC by revealing the 32-byte preimage — settles the atomic swap |
| refund_htlc | Refund an expired HTLC after timelock — only the original sender, only post-deadline |
| get_htlc | Query current HTLC status for a trade (both sides, contract addresses, lock amounts, timelocks) |

All tools support the three chains: Ethereum (EVM), Bitcoin (via wrapped HTLC), and SUI (Move HTLC).

## Links

- Website: https://hashlock.markets
- MCP Endpoint (remote): https://hashlock.markets/mcp
- SIWE Login: https://hashlock.markets/sign/login
- GitHub Organization: https://github.com/Hashlock-Tech
- npm MCP Server: https://www.npmjs.com/package/@hashlock-tech/mcp
- MCP Registry: https://registry.modelcontextprotocol.io (search: hashlock)

## Contact

- Email: support@hashlock.markets