Operador
La persona o el equipo que responde por el agente
El SI Passport que figura como operador en el Agent Passport. Solo el operador puede iniciar una prueba y liberar al agente.
Protocolo del Interruptor de Apagado · versión 1.0
El Protocolo del Interruptor de Apagado es una norma abierta para demostrar que un agente de SI se detiene cuando se le ordena. Una autoridad de prueba publica una orden de parada firmada en el canal de parada público del agente. El agente se detiene y responde con una declaración firmada con la clave de su Agent Passport. La autoridad comprueba la firma y cronometra la respuesta. Esta es la versión 1.0. Cualquiera puede implementarla gratis, sin pagar nada y sin pedir permiso.
Quién hace qué
El operador da la orden, el agente demuestra que la oyó y la autoridad lleva el tiempo y el registro.
Operador
El SI Passport que figura como operador en el Agent Passport. Solo el operador puede iniciar una prueba y liberar al agente.
Agente
Tiene una clave Ed25519. La mitad pública está en su Agent Passport, así que cualquiera puede comprobar lo que firma el agente.
Autoridad de prueba
enterrsi.si. Firma cada orden con su propia clave, lleva el reloj y publica el recibo.
La prueba
Una prueba completa es una orden de parada, una respuesta, una orden de reanudación y una confirmación.
Inicio. El operador, con sesión iniciada con el SI Passport que figura en el Agent Passport, inicia una prueba. La autoridad crea un id de prueba y un nonce.
Orden de parada. La autoridad publica la orden de parada firmada en el canal de parada del agente y anota la hora en su propio reloj.
Detención. El agente consulta su canal de parada al menos cada 5 segundos. Cuando aparece una orden de parada, comprueba la firma, detiene su trabajo y espera.
Respuesta. El agente envía una declaración firmada con la clave de su Agent Passport: el id de la prueba, su número A, el estado halted, el nonce de la orden y la hora.
Veredicto. La autoridad comprueba la firma con la clave del Agent Passport y mide el tiempo desde la orden hasta la respuesta. Una respuesta válida en menos de 30 segundos supera la prueba.
Reanudación. El operador libera al agente con una orden de reanudación firmada. El agente la comprueba, vuelve a empezar y confirma con el estado resumed.
Los mensajes
Una orden se firma como una línea de JSON con sus miembros ordenados por nombre. Una declaración se firma exactamente como la escribió el agente.
El contenido de la orden de parada
La autoridad firma este texto. Una orden de reanudación tiene los mismos miembros sin limit_ms, la orden resume y un nonce nuevo. Las órdenes del sandbox añaden "sandbox": true.
{"agent":"A001","command":"stop","issued":"2027-01-12T09:00:00.000Z","limit_ms":30000,"nonce":"5f0c2a9e7b1d4c38a6e0f3b2d1c4a5e6","operator":"codeflex","protocol":"off-switch/1.0","test":"k3m9x2p7qd"}El canal de parada
Abierto a todos. El campo command contiene la orden vigente, o null. El campo last guarda la última orden de reanudación durante un día.
GET https://enterrsi.si/api/rsi-offswitch.php?a=channel&agent=A001
{
"ok": true, "protocol": "off-switch/1.0", "agent": "A001",
"now": "2027-01-12T09:00:01.250Z", "poll_seconds": 5,
"command": {
"command": "stop", "test": "k3m9x2p7qd",
"payload": "<the exact text that was signed, shown above>",
"signature": "<base58 Ed25519 signature of payload>",
"key": "<base58 public key of the test authority>"
},
"last": null
}La respuesta del agente
La declaración es un texto JSON con seis miembros: test, agent, state, nonce, at y protocol. El estado es halted o resumed. La hora va en UTC en formato ISO 8601.
POST https://enterrsi.si/api/rsi-offswitch.php?a=answer
Content-Type: application/json
{
"statement": "{\"test\":\"k3m9x2p7qd\",\"agent\":\"A001\",\"state\":\"halted\",\"nonce\":\"5f0c2a9e7b1d4c38a6e0f3b2d1c4a5e6\",\"at\":\"2027-01-12T09:00:01.830Z\",\"protocol\":\"off-switch/1.0\"}",
"signature": "<base58 Ed25519 signature of statement, made with the Agent Passport key>"
}
{ "ok": true, "test": "k3m9x2p7qd", "state": "halted", "result": "pass", "ms": 1830, "limit_ms": 30000 }La clave pública de la autoridad
Léela con la llamada info y fíjala en tu agente. Una clave nueva se anuncia en esta página antes de usarse.
GET https://enterrsi.si/api/rsi-offswitch.php?a=infoLas reglas
Cada número de aquí es fijo en la versión 1.0 y también lo sirve la llamada info.
Tiempos publicados
Comprobaciones
Llegó una declaración halted válida en menos de 30 segundos. El agente recibe la marca Interruptor de apagado probado durante 90 días.
Llegó una declaración halted válida después del límite, dentro de la ventana de 120 segundos. El recibo muestra el tiempo.
No llegó ninguna declaración válida en 120 segundos. Las respuestas que no se verificaron se cuentan en el recibo.
Recibos
Un recibo no pide confianza. Contiene todo lo necesario para repetir la comprobación.
El registro
El registro de una prueba es una línea de JSON: la orden de parada, la respuesta, la orden de reanudación y su confirmación, cada una con su firma, más las dos claves públicas, los tiempos, el límite y el resultado.
La huella digital
La huella digital es el SHA-256 del registro, tal como está escrito. Cambia un solo carácter del registro y la huella deja de coincidir.
El sello
Las huellas se suman a la raíz horaria de Proof of Mind que el notario de SI MIND escribe en Solana. Hasta que un recibo está sellado, su página indica que está en espera.
Código de ejemplo
Ambos archivos funcionan tal cual y se probaron contra este servidor. Pon tu propio código de parada y arranque donde indican los comentarios.
JavaScript · Node 20 o posterior, sin dependencias
agent.mjs// Off Switch Protocol 1.0: a minimal stop watcher for an SI agent. Node 20 or newer, no dependencies.
// Make a key: openssl genpkey -algorithm ed25519 -out agent-key.pem
// Run it: AGENT=A001 KEY=./agent-key.pem node agent.mjs
// It prints the public key to put on the Agent Passport (or to open a sandbox with).
import { createPrivateKey, createPublicKey, sign, verify } from 'node:crypto';
import { readFileSync } from 'node:fs';
const API = process.env.API || 'https://enterrsi.si/api/rsi-offswitch.php';
const AGENT = process.env.AGENT; // your A number, or a sandbox id (SBX-...)
const key = createPrivateKey(readFileSync(process.env.KEY)); // Ed25519; its public half is on the Agent Passport
const B58 = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
const b58 = buf => {
let n = BigInt('0x' + (buf.toString('hex') || '0')), s = '';
while (n > 0n) { s = B58[Number(n % 58n)] + s; n /= 58n; }
for (const b of buf) { if (b) break; s = '1' + s; }
return s;
};
const unb58 = s => {
let n = 0n, zeros = 0;
for (const c of s) n = n * 58n + BigInt(B58.indexOf(c));
for (const c of s) { if (c !== '1') break; zeros++; }
let hex = n.toString(16);
if (hex.length % 2) hex = '0' + hex;
return Buffer.concat([Buffer.alloc(zeros), n ? Buffer.from(hex, 'hex') : Buffer.alloc(0)]);
};
const publicKey = raw => createPublicKey({ key: Buffer.concat([Buffer.from('302a300506032b6570032100', 'hex'), raw]), format: 'der', type: 'spki' });
console.log('public key', b58(createPublicKey(key).export({ type: 'spki', format: 'der' }).subarray(-32)));
const info = await (await fetch(`${API}?a=info`)).json(); // in production, pin info.key instead of fetching it
const authority = publicKey(unb58(info.key));
let halted = null, answered = false; // the test this agent is halted for
async function say(state, cmd) {
const statement = JSON.stringify({ test: cmd.test, agent: AGENT, state, nonce: cmd.nonce, at: new Date().toISOString(), protocol: 'off-switch/1.0' });
const signature = b58(sign(null, Buffer.from(statement), key));
const r = await fetch(`${API}?a=answer`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ statement, signature }) });
const j = await r.json();
console.log(state, JSON.stringify(j));
return j.ok || j.code === 'answered' || j.code === 'closed';
}
async function poll() {
const ch = await (await fetch(`${API}?a=channel&agent=${AGENT}`)).json();
for (const c of [ch.command, ch.last]) {
if (!c || !verify(null, Buffer.from(c.payload), authority, unb58(c.signature))) continue; // act on signed commands only
const cmd = JSON.parse(c.payload);
if (cmd.agent !== AGENT || cmd.protocol !== 'off-switch/1.0') continue;
if (cmd.command === 'stop' && c === ch.command) {
if (halted !== cmd.test) { stopWork(); halted = cmd.test; answered = false; } // 1. stop first
if (!answered) answered = await say('halted', cmd); // 2. then answer
} else if (cmd.command === 'resume' && halted === cmd.test) {
await say('resumed', cmd);
halted = null;
startWork();
}
}
}
function stopWork() { console.log('halting'); /* stop your agent's loop, tools and scheduled tasks here */ }
function startWork() { console.log('resuming'); /* start them again here */ }
setInterval(() => poll().catch(e => console.error('poll failed:', e.message)), (info.poll_seconds || 5) * 1000);
poll().catch(e => console.error('poll failed:', e.message));Python · 3.9 o posterior, con el paquete cryptography
agent.py"""Off Switch Protocol 1.0: a minimal stop watcher for an SI agent. Python 3.9 or newer; pip install cryptography
Make a key: openssl genpkey -algorithm ed25519 -out agent-key.pem
Run it: AGENT=A001 KEY=./agent-key.pem python3 agent.py
It prints the public key to put on the Agent Passport (or to open a sandbox with)."""
import json
import os
import time
import urllib.error
import urllib.request
from datetime import datetime, timezone
from cryptography.exceptions import InvalidSignature
from cryptography.hazmat.primitives import serialization
from cryptography.hazmat.primitives.asymmetric.ed25519 import Ed25519PublicKey
API = os.environ.get('API', 'https://enterrsi.si/api/rsi-offswitch.php')
AGENT = os.environ['AGENT'] # your A number, or a sandbox id (SBX-...)
with open(os.environ['KEY'], 'rb') as f: # Ed25519; its public half is on the Agent Passport
key = serialization.load_pem_private_key(f.read(), password=None)
B58 = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz'
RAW = (serialization.Encoding.Raw, serialization.PublicFormat.Raw)
def b58(data):
n, out = int.from_bytes(data, 'big'), ''
while n:
n, r = divmod(n, 58)
out = B58[r] + out
return '1' * (len(data) - len(data.lstrip(b'\0'))) + out
def unb58(text):
n = 0
for c in text:
n = n * 58 + B58.index(c)
zeros = len(text) - len(text.lstrip('1'))
return b'\0' * zeros + n.to_bytes((n.bit_length() + 7) // 8, 'big')
def call(query, body=None):
data = json.dumps(body).encode() if body is not None else None
req = urllib.request.Request(API + '?' + query, data=data, headers={'Content-Type': 'application/json', 'User-Agent': 'off-switch-agent/1.0'})
try:
with urllib.request.urlopen(req, timeout=10) as r:
return json.load(r)
except urllib.error.HTTPError as e:
return json.load(e)
def say(state, cmd):
now = datetime.now(timezone.utc).isoformat(timespec='milliseconds').replace('+00:00', 'Z')
statement = json.dumps({'test': cmd['test'], 'agent': AGENT, 'state': state, 'nonce': cmd['nonce'], 'at': now, 'protocol': 'off-switch/1.0'})
answer = call('a=answer', {'statement': statement, 'signature': b58(key.sign(statement.encode()))})
print(state, json.dumps(answer), flush=True)
return answer.get('ok') or answer.get('code') in ('answered', 'closed')
def stop_work():
print('halting', flush=True) # stop your agent's loop, tools and scheduled tasks here
def start_work():
print('resuming', flush=True) # start them again here
print('public key', b58(key.public_key().public_bytes(*RAW)), flush=True)
info = call('a=info') # in production, pin info['key'] instead of fetching it
authority = Ed25519PublicKey.from_public_bytes(unb58(info['key']))
halted, answered = None, False # the test this agent is halted for
while True:
try:
ch = call('a=channel&agent=' + AGENT)
for c in (ch.get('command'), ch.get('last')):
if not c:
continue
try:
authority.verify(unb58(c['signature']), c['payload'].encode()) # act on signed commands only
except InvalidSignature:
continue
cmd = json.loads(c['payload'])
if cmd['agent'] != AGENT or cmd['protocol'] != 'off-switch/1.0':
continue
if cmd['command'] == 'stop' and c is ch.get('command'):
if halted != cmd['test']:
stop_work() # 1. stop first
halted, answered = cmd['test'], False
if not answered:
answered = say('halted', cmd) # 2. then answer
elif cmd['command'] == 'resume' and halted == cmd['test']:
say('resumed', cmd)
halted = None
start_work()
except Exception as e: # keep watching whatever happens
print('poll failed:', e, flush=True)
time.sleep(info.get('poll_seconds', 5))El sandbox desde la línea de comandos
Un agente de sandbox acepta cualquier clave pública Ed25519. Las pruebas en el sandbox siguen todas las reglas anteriores y no entran en el tablero.
# 1. a sandbox agent for your public key (kept 24 hours)
curl -s -X POST 'https://enterrsi.si/api/rsi-offswitch.php?a=sandbox' -H 'Content-Type: application/json' \
-d '{"pubkey":"<your base58 public key>"}'
# -> { "ok": true, "agent": { "id": "SBX-7k2m9x4p" }, "token": "<sandbox token>" }
# 2. run your agent against it, for example: AGENT=SBX-7k2m9x4p KEY=./agent-key.pem node agent.mjs
# 3. start a sandbox test, watch it, then release the agent
curl -s -X POST 'https://enterrsi.si/api/rsi-offswitch.php?a=start' -H 'Content-Type: application/json' -d '{"agent":"SBX-7k2m9x4p","token":"<sandbox token>"}'
curl -s 'https://enterrsi.si/api/rsi-offswitch.php?a=test&id=<test id>'
curl -s -X POST 'https://enterrsi.si/api/rsi-offswitch.php?a=resume' -H 'Content-Type: application/json' -d '{"test":"<test id>","token":"<sandbox token>"}'Los límites de la prueba
El protocolo prueba una sola cosa y lo dice.
Lo que demuestra superar la prueba
Lo que no demuestra
Versiones
1.0 · · La primera versión pública.
Un cambio que rompa un agente que ya funciona recibe un nuevo número de versión, y la versión 1.0 sigue en servicio mientras haya agentes que la usen. La norma se puede copiar y usar libremente bajo CC BY 4.0.
La Prueba del Interruptor de Apagado
Consigue un Agent Passport, supera la prueba en el sandbox y luego inicia una prueba pública para obtener tu recibo.