Escribir un código de cadena
Un código de cadena se escribe en Go, Node.js o Java y, a continuación, se empaqueta en un archivo ZIP que se instala en la red de Oracle Blockchain Platform.
Los códigos de cadenas definen el esquema de datos en el libro mayor, lo inicializan, completan las actualizaciones cuando las aplicaciones lo disparan y responden a las consultas. Los códigos de cadenas también pueden publicar eventos que permiten a las aplicaciones recibir notificaciones y completar operaciones descendentes. Por ejemplo, una vez que las órdenes de compra, las facturas y los registros de entrega se han confrontado con un código de cadena, puede publicar un evento para que una aplicación de suscripción pueda procesar pagos relacionados y actualizar un sistema de ERP interno.
Recursos para el desarrollo de Chaincode
Oracle Blockchain Platform utiliza Hyperledger Fabric como base. Utilice la documentación de Hyperledger Fabric para ayudarle a escribir códigos de cadenas válidos.
-
Bienvenido a Hyperledger Fabric. Lea las secciones Conceptos clave y tutoriales antes de escribir su propio código de cadenas.
-
Ir a lenguaje de programación. Los compiladores, herramientas y bibliotecas Go proporcionan una variedad de recursos que simplifican la escritura de códigos de cadenas.
-
Impresión de paquete. Package shim proporciona API para que el código de cadenas acceda a sus variables de estado, obtenga el contexto de la transacción y llame a otros códigos de cadenas. La documentación de la dimensión del paquete describe la sintaxis real necesaria para el código de cadenas.
Oracle Blockchain Platform proporciona ejemplos descargables que le ayudarán a comprender cómo escribir códigos de cadenas y aplicaciones. Consulte Definición de Ejemplos de Código de Cadena
Puede agregar sintaxis de consulta enriquecida a los códigos de cadenas para consultar la base de datos de estado. Consulte Sintaxis de consulta enriquecida de SQL y Sintaxis de consulta enriquecida de CouchDB.
Empaquetar un código de cadena de Go
Después de haber escrito su código de cadena, comprímalo a un archivo en formato ZIP. No es necesario crear un paquete para el código de cadena Go ni firmarlo. El proceso de instalación y despliegue de Oracle Blockchain Platform lo hace por usted como se describe en Typical Workflow to Deploy Chaincodes (Hyperledger Fabric v2.x).
Si el código de cadenas tiene dependencias externas, puede colocarlos en el directorio de proveedores del archivo ZIP.
Proporcionar Shim para Go Chaincodes
La dependencia de dimensión de código de cadena Go, que anteriormente se incluía con versiones anteriores de Hyperledger Fabric, no se incluye con Hyperledger Fabric v2.x. El shim ahora debe venderse (importarse) a los códigos de cadena Go antes de que se instalen en un par.
Puede utilizar módulos Go o una herramienta de terceros, como Govendor, para proporcionar la dimensión de código de cadena y actualizarla a la versión que funciona con Hyperledger Fabric v2.x.
Para obtener más información, consulte Chaincode shim changes (Go chaincode only) y Upgrade Chaincodes with vendored shim en la documentación de Hyperledger Fabric. Para obtener más información sobre los módulos Go, consulte Referencia de módulos Go.
Empaquetar un código de cadena Node.js
package.json con dos secciones:
-
La sección
scriptsdeclara cómo iniciar el código de cadena. -
La sección
dependenciesespecifica las dependencias.
A continuación, se muestra un ejemplo de package.json para un código de cadena Node.js:
{
"name": "chaincode_example02",
"version": "1.0.0",
"description": "chaincode_example02 chaincode implemented in Node.js",
"engines": {
"node": ">=8.4.0",
"npm": ">=5.3.0"
},
"scripts": { "start" : "node chaincode_example02.js" },
"engine-strict": true,
"license": "Apache-2.0",
"dependencies": {
"fabric-shim": "~1.3.0"
}
}
- El archivo
package.jsondebe estar en el directorio raíz. - El archivo de entrada JavaScript se puede encontrar en cualquier parte del paquete.
- Si no se especifica
"start" : "node <start>.js"en el archivopackage.json, el archivoserver.jsdebe estar en el directorio raíz.
Comprima el código de cadena y el archivo de paquete en formato ZIP para instalarlo en Oracle Blockchain Platform.
Empaquetado de un código de cadenas Java
Si está escribiendo un código de cadena Java, puede elegir Gradle o Maven para crear el código de cadena.
Archive: example_gradle.zip
Length Date Time Name
--------- ---------- ----- ----
610 02-14-2019 01:36 build.gradle
54 02-14-2019 01:28 settings.gradle
0 02-14-2019 01:28 src/
0 02-14-2019 01:28 src/main/
0 02-14-2019 01:28 src/main/java/
0 02-14-2019 01:28 src/main/java/org/
0 02-14-2019 01:28 src/main/java/org/hyperledger/
0 02-14-2019 01:28 src/main/java/org/hyperledger/fabric/
0 02-14-2019 01:28 src/main/java/org/hyperledger/fabric/example/
5357 02-14-2019 01:28 src/main/java/org/hyperledger/fabric/example/SimpleChaincode.java
--------- -------
6021 10 filesArchive: example_maven.zip
Length Date Time Name
--------- ---------- ----- ----
3313 02-14-2019 01:52 pom.xml
0 02-14-2019 01:28 src/
0 02-14-2019 01:28 src/chaincode/
0 02-14-2019 01:28 src/chaincode/example/
4281 02-14-2019 01:28 src/chaincode/example/SimpleChaincode.java
--------- -------
7594 5 filesPrueba de un código de cadena
Pruebe el código de cadenas después de escribirlo. Consulte los temas siguientes:
-
Uso de Simulación Simulatoria para Probar un Código de Cadena
-
Despliegue de un código de cadena en un par para probar el código de cadena
Instalación y despliegue de un código de cadenas
Después de probar el código de cadenas, puede desplegarlo siguiendo la información de Flujo de trabajo típico para desplegar códigos de cadenas (Hyperledger Fabric v2.x).
Actualización de un código de cadena
Actualice un código de cadena desplegado siguiendo los pasos de Upgrade a Chaincode (Hyperledger Fabric v2.x).