🚧 La documentacion de Bloque está en desarrollo
close
Bloque Docs
  • Español
      • Before this
      • SDK instalado
      • Origin Key del dashboard de Bloque
      After this5 min
      • Identidad registrada
      • URN para el usuario
      • Cliente autenticado

      Registrar

      El registro crea una identidad permanente para un usuario (o entidad) en tu Origen. Después del registro, obtienes de vuelta un cliente autenticado listo para usar.

      ¿Qué es el registro?

      Registro
      Vincular un alias a un Origen, creando una Identidad permanente con un URN. Es el primer paso para cualquier nuevo usuario. Después del registro, el usuario puede autenticarse con connect().

      El registro es una operación de una sola vez por usuario por Origen. Llamarlo de nuevo con el mismo alias fallará — usa connect() para usuarios que regresan.

      ¿Qué es una Origin Key?

      Origin Key
      Tu credencial backend que te autoriza a registrar identidades en tu Origen. Piénsala como la 'clave admin' de tu namespace. Nunca la expongas en el cliente.
      BLOQUE_ORIGIN_KEY=ok_live_...

      Registrar un individuo

      import { SDK } from '@bloque/sdk'

const sdk = new SDK({
  origin: 'tu-origen',
  auth: {
    type: 'originKey',
    originKey: process.env.BLOQUE_ORIGIN_KEY!,
  },
  mode: 'sandbox',
})

const client = await sdk.register('@alice', {
  type: 'individual',
  profile: {
    firstName: 'Alice',
    lastName: 'Smith',
    email: 'alice@ejemplo.com',
    phone: '+573001234567',
    birthdate: '1990-06-15',
    city: 'Bogotá',
    state: 'Cundinamarca',
    postalCode: '110111',
    countryOfBirthCode: 'CO',
    countryOfResidenceCode: 'CO',
  },
})

console.log(client.urn)         // did:bloque:tu-origen:@alice
console.log(client.accessToken) // JWT — válido ~15 minutos
      Deberías ver un URN impreso
      did:bloque:tu-origen:@alice
      Si obtienes error 409, el alias ya está registrado — usa connect() en su lugar.

      Registrar una empresa

      const client = await sdk.register('@acme-corp', {
  type: 'business',
  profile: {
    legalName: 'Acme Corp S.A.S.',
    taxId: '900123456-7',
    incorporationDate: '2020-01-15',
    businessType: 'sas',
    countryCode: 'CO',
    address: 'Calle 100 # 8A-55',
    city: 'Bogotá',
    postalCode: '110221',
    ownerFirstName: 'Carlos',
    ownerLastName: 'Gómez',
    ownerIdType: 'CC',
    ownerIdNumber: '1234567890',
  },
})

      Tipos de Origen

      TipoEjemploAutenticación
      Integradosbloque-email, bloque-whatsappCódigo OTP
      Blockchainethereum-mainnet, solana-devnetFirma de wallet
      Personalizadostu-app-nombreTu Origin Key

      ¿Cuál es la diferencia entre register() y connect()?

      register()connect()
      CuándoPrimera vez — crea la identidadUsuario que regresa — abre sesión
      ResultadoNuevo URN + cliente autenticadoCliente autenticado
      Falla siEl alias ya existeEl alias no existe

      ¿Qué sigue?

      → Conectar — abre sesiones para usuarios que regresan