Ir para a navegação

MPC · Solicitar assinatura

Ver como Markdown

Existem três preocupações distintas de assinatura: autenticar a solicitação HTTP, autorizar uma retirada específica e produzir a assinatura blockchain com MPC participantes. Passar na primeira verificação não substitui as outras duas.

Autenticar uma solicitação API

O API atual usa HMAC-SHA256 com um identificador de chave e segredo API. Sua solicitação canônica contém cinco linhas, separadas por uma nova linha, sem nova linha à direita:

METHOD
PATH
SORTED_QUERY
BODY_SHA256_HEX
UNIX_TIMESTAMP_SECONDS

Use o método HTTP maiúsculo e solicite o caminho sem o host. Classifique as chaves de consulta, mantenha a ordem dos valores repetidos e aplique a codificação do formulário URL, incluindo + para espaços. A linha de consulta fica vazia quando não existe nenhuma consulta. Faça hash dos bytes exatos do corpo usando SHA-256, incluindo o corpo vazio para uma solicitação sem corpo.

Calcule HMAC-SHA256 usando o segredo fornecido como UTF-8 bytes; não o decodifique em hexadecimal apenas porque parece hexadecimal. Codifique o resultado como hexadecimal minúsculo. Os campos de cabeçalho são separados por espaços:

Authorization: HMAC-SHA256 keyId=<KEY_ID> signature=<HEX_SIGNATURE> timestamp=<UNIX_SECONDS>

Exemplo de assinatura somente leitura

Este auxiliar de biblioteca padrão constrói cabeçalhos para uma consulta de depósito; ele não envia uma solicitação. Carregue as credenciais com segurança em sua aplicativo e envie o caminho retornado inalterado para a base URL fornecida para seu ambiente.

import hashlib
import hmac
import time
from urllib.parse import urlencode
def signed_read_headers(key_id, secret, timestamp=None):
method = "GET"
path = "/api/v1/deposits"
query = urlencode(sorted([("page", "1"), ("page_size", "20")]))
body = b""
ts = str(int(time.time()) if timestamp is None else timestamp)
canonical = "\n".join([
method, path, query, hashlib.sha256(body).hexdigest(), ts
])
signature = hmac.new(
secret.encode("utf-8"), canonical.encode("utf-8"), hashlib.sha256
).hexdigest()
return path + "?" + query, {
"Authorization": (
f"HMAC-SHA256 keyId={key_id} signature={signature} timestamp={ts}"
)
}

Mantenha os relógios sincronizados. Um proxy que altera o caminho, a consulta ou o corpo após a assinatura pode invalidar a autenticação. Para falhas de autenticação, inspecione o motivo da resposta e o identificador da solicitação antes de tentar novamente; nunca registre o cabeçalho secreto ou de autorização completa.

Autorizar uma retirada API

O atual fluxo de retirada da empresa API também requer uma autorização do cliente Ed25519 em client_authorization. Ele vincula o contexto da transação pretendida, incluindo o identificador da solicitação, destino, ativo e valor. Seu registro de chave pública ou configuração de confiança depende do arranjo de custódia.

Use o pacote de integração correspondente para produzir a carga canônica, a assinatura e a chave pública. Esta chave de autorização é separada do segredo HMAC e dos compartilhamentos MPC. Preservar sua chave privada sob controle do cliente. Confirme a versão da carga útil e as regras de validade durante a integração em vez de criar um formato personalizado a partir desta visão geral.

Depois que a solicitação for aceita, verificações e aprovações comerciais ainda poderão ser aplicadas, seguidas de assinatura MPC e confirmação da cadeia. Ver transações e novas tentativas.