# Encrypt operations

Wax library provides a simple interface for operations encryption withing transaction using Transaction Builder interface.

# Operations That Can Be Encrypted

Currently, the following operations can be encrypted using the @hiveio/wax library:

comment - Encrypts the body field.
custom_json - Encrypts the json field. Custom JSON encryption is unique as it wraps the encrypted data in an encrypted key.
transfer - Encrypts the memo field.
transfer_to_savings - Encrypts the memo field.
transfer_from_savings - Encrypts the memo field.
recurrent_transfer - Encrypts the memo field.

Non-encrypted operations

Upon operating in the encrypted transaction builder interface (startEncrypt method invoked), operations that are not able to be encrypted will be saved to the transaction as is

# Encrypting Operations within a Transaction

Test it yourself: src/typescript/encryption/encrypt-operations/one-key.ts

import { createHiveChain } from "@hiveio/wax";

const { wallet, publicKey1 } = globalThis.snippetsBeekeeperData; /* Import preconfigured beekeeper data specific to snippet examples */

const hiveChain = await createHiveChain();

// Create a transaction builder
const tx = await hiveChain.getTransactionBuilder();

// Start the encryption chain
tx.startEncrypt(publicKey1)
  .push({ // Add encrypted operation
    transfer: {
      from: "alice",
      to: "bob",
      amount: hiveChain.hive(100),
      memo: "This memo will be encrypted"
    }
  })
  .stopEncrypt(); // Stop the encryption chain

// Sign and build the transaction
const signedTx = tx.build(wallet, publicKey1);

console.log(signedTx);

publicKey1 used here for the transaction signing may differ from the public key used for operations encryption

Test it yourself: src/typescript/encryption/encrypt-operations/multiple-keys.ts

import { createHiveChain } from "@hiveio/wax";

const { wallet, publicKey1, publicKey2 } = globalThis.snippetsBeekeeperData; /* Import preconfigured beekeeper data specific to snippet examples */

const hiveChain = await createHiveChain();

// Create a transaction builder
const tx = await hiveChain.getTransactionBuilder();

// Start the encryption chain with two keys
tx.startEncrypt(publicKey1, publicKey2)
  .push({ // Add encrypted operations
    transfer: {
      from: "alice",
      to: "bob",
      amount: hiveChain.hive(100),
      memo: "This memo will be encrypted with two keys"
    }
  })
  .stopEncrypt(); // Stop the encryption chain

// Sign and build the transaction
const signedTx = tx.build(wallet, publicKey1);

console.log(signedTx);

publicKey1 used here for the transaction signing may differ from the public key used for operations encryption

Test it yourself: src/typescript/encryption/encrypt-operations/multiple-start-encrypt.ts

import { createHiveChain } from "@hiveio/wax";

const { wallet, publicKey1, publicKey2 } = globalThis.snippetsBeekeeperData; /* Import preconfigured beekeeper data specific to snippet examples */

const hiveChain = await createHiveChain();

// Create a transaction builder
const tx = await hiveChain.getTransactionBuilder();

// Start the encryption chain with two keys
tx.startEncrypt(publicKey1, publicKey2)
  .push({ // Add encrypted operations
    transfer: {
      from: "alice",
      to: "bob",
      amount: hiveChain.hive(100),
      memo: "This memo will be encrypted with two keys"
    }
  })
  .stopEncrypt() // Stop the current encryption chain
  .startEncrypt(publicKey1) // Start the encryption chain again, but with one key only
  .push({ // Add other encrypted operations
    transfer: {
      from: "alice",
      to: "bob",
      amount: hiveChain.hive(100),
      memo: "This memo will be encrypted with one key only"
    }
  })
  .stopEncrypt(); // Stop the encryption chain again (optionally)

// Sign and build the transaction
const signedTx = tx.build(wallet, publicKey1);

console.log(signedTx);

publicKey1 used here for the transaction signing may differ from the public key used for operations encryption

These examples demonstrate how to handle encryption and decryption using both direct methods and the transaction builder interface in the Wax library.