hiero-ledger
diff --git a/‎.github/workflows/build.yml‎
Lines changed: 3 additions & 0 deletions b/‎.github/workflows/build.yml‎
Lines changed: 3 additions & 0 deletions
diff --git a/‎examples/hooks/HieroHookContract.sol‎
Lines changed: 93 additions & 0 deletions b/‎examples/hooks/HieroHookContract.sol‎
Lines changed: 93 additions & 0 deletions
diff --git a/‎examples/hooks/account/main.go‎
Lines changed: 195 additions & 0 deletions b/‎examples/hooks/account/main.go‎
Lines changed: 195 additions & 0 deletions
@@ -101,6 +101,7 @@ jobs:
               uses: hiero-ledger/hiero-solo-action@dd0048139ef1e40fd6067f01bf94eb42a67294f4 # v0.15.0
               with:
                 installMirrorNode: true
+                hieroVersion: v0.69.0-alpha.1
 
             - name: Set Operator Account
               if: success() && matrix.test-type == 'e2e'
@@ -172,6 +173,7 @@ jobs:
               uses: hiero-ledger/hiero-solo-action@dd0048139ef1e40fd6067f01bf94eb42a67294f4 # v0.14.0
               with:
                 installMirrorNode: true
+                hieroVersion: v0.69.0-alpha.1
 
             - name: Set Operator Account
               run: |
@@ -231,6 +233,7 @@ jobs:
               uses: hiero-ledger/hiero-solo-action@dd0048139ef1e40fd6067f01bf94eb42a67294f4 # v0.15.0
               with:
                 installMirrorNode: true
+                hieroVersion: v0.69.0-alpha.1
 
             - name: Set Operator Account
               run: |
 
@@ -0,0 +1,93 @@
+// SPDX-License-Identifier: Apache-2.0
+pragma solidity >=0.4.9 <0.9.0;
+pragma experimental ABIEncoderV2;
+/// The interface for a generic EVM hook.
+interface IHieroHook {
+    /// The context the hook is executing in
+    struct HookContext {
+        /// The address of the entity the hook is executing on behalf of
+        address owner;
+        /// The fee the transaction payer was charged for the triggering transaction
+        uint256 txnFee;
+        /// The gas cost the transaction payer was charged for specifically this hook
+        uint256 gasCost;
+        /// The memo of the triggering transaction
+        string memo;
+        /// Any extra call data passed to the hook
+        bytes data;
+    }
+}
+/// The interface for an account allowance hook invoked once before a CryptoTransfer.
+interface IHieroAccountAllowanceHook {
+    /// A single balance adjustment in the range of a Hiero native token
+    struct AccountAmount {
+        // The address of the account whose balance is changing
+        address account;
+        // The amount in atomic units of the change
+        int64 amount;
+    }
+    /// A single NFT ownership change
+    struct NftTransfer {
+        // The address of the sender
+        address sender;
+        // The address of the receiver
+        address receiver;
+        // The serial number being transferred
+        int64 serialNo;
+    }
+    /// A zero-sum list of balance adjustments for a Hiero-native token
+    struct TokenTransferList {
+        // The Hiero token address
+        address token;
+        // For a fungible token, the zero-sum balance adjustments
+        AccountAmount[] adjustments;
+        // For a non-fungible token, the NFT ownership changes
+        NftTransfer[] nftTransfers;
+    }
+    /// Combines HBAR and HTS asset transfers.
+    struct Transfers {
+        /// A zero-sum list of balance adjustments for HBAR specifically
+        AccountAmount[] hbarAdjustments;
+        /// The HTS token transfers
+        TokenTransferList[] tokens;
+    }
+    /// Combines the full proposed transfers for a Hiero transaction,
+    /// including both its direct transfers and the implied HIP-18
+    /// custom fee transfers.
+    struct ProposedTransfers {
+        /// The transaction's direct transfers
+        Transfers direct;
+        /// The transaction's assessed custom fees
+        Transfers customFee;
+    }
+    /// Decides if the proposed transfers are allowed, optionally in
+    /// the presence of additional context encoded by the transaction
+    /// payer in the extra calldata.
+    /// @param context The context of the hook call
+    /// @param proposedTransfers The proposed transfers
+    /// @return true If the proposed transfers are allowed, false or revert otherwise
+    function allow(
+        IHieroHook.HookContext calldata context,
+        ProposedTransfers memory proposedTransfers
+    ) external payable returns (bool);
+}
+contract AlwaysAllowAccountAllowancePrePostHook is IHieroAccountAllowanceHook {
+    function allowPre(
+        IHieroHook.HookContext calldata /* context */,
+        ProposedTransfers memory /* proposedTransfers */
+    ) external payable returns (bool) {
+        return true;
+    }
+    function allowPost(
+        IHieroHook.HookContext calldata /* context */,
+        ProposedTransfers memory /* proposedTransfers */
+    ) external payable returns (bool) {
+        return true;
+    }
+    function allow(
+        IHieroHook.HookContext calldata context,
+        ProposedTransfers memory proposedTransfers
+    ) external payable returns (bool) {
+        return true;
+    }
+}
@@ -0,0 +1,195 @@
+package main
+
+import (
+	"fmt"
+	"os"
+
+	"github.com/hiero-ledger/hiero-sdk-go/v2/examples/hooks/utils"
+	hiero "github.com/hiero-ledger/hiero-sdk-go/v2/sdk"
+)
+
+// HIP-1195 example for creating and updating an account with a hook
+func main() {
+	var client *hiero.Client
+	var err error
+
+	// Retrieving network type from environment variable HEDERA_NETWORK
+	client, err = hiero.ClientForName(os.Getenv("HEDERA_NETWORK"))
+	if err != nil {
+		panic(fmt.Sprintf("%v : error creating client", err))
+	}
+	defer client.Close()
+
+	// Retrieving operator ID from environment variable OPERATOR_ID
+	operatorAccountID, err := hiero.AccountIDFromString(os.Getenv("OPERATOR_ID"))
+	if err != nil {
+		panic(fmt.Sprintf("%v : error converting string to AccountID", err))
+	}
+
+	// Retrieving operator key from environment variable OPERATOR_KEY
+	operatorKey, err := hiero.PrivateKeyFromString(os.Getenv("OPERATOR_KEY"))
+	if err != nil {
+		panic(fmt.Sprintf("%v : error converting string to PrivateKey", err))
+	}
+
+	// Setting the client operator ID and key
+	client.SetOperator(operatorAccountID, operatorKey)
+
+	fmt.Println("Creating hook contract")
+	hookContractId := utils.CreateHookContractId(client)
+	fmt.Printf("Hook contract created: %v\n", hookContractId)
+
+	fmt.Println("Creating account with hook")
+	createAccountWithHook(client, hookContractId)
+
+	fmt.Println("Updating account to add hook")
+	addHookToAccount(client, hookContractId)
+
+	fmt.Println("Updating account to delete hook")
+	deleteHookFromAccount(client, hookContractId)
+
+	fmt.Println("Example completed")
+}
+
+func createAccountWithHook(client *hiero.Client, hookContractId *hiero.ContractID) {
+	fmt.Println("Creating account with hook...")
+
+	// Create hook detail
+	hookDetail := hiero.NewHookCreationDetails().
+		SetExtensionPoint(hiero.ACCOUNT_ALLOWANCE_HOOK).
+		SetHookId(1).
+		SetLambdaEvmHook(*hiero.NewLambdaEvmHook().SetContractId(hookContractId))
+
+	// Generate account private key
+	fmt.Println("Generating account private key...")
+	accountPrivateKey, err := hiero.PrivateKeyGenerateEd25519()
+	if err != nil {
+		panic(fmt.Sprintf("%v : error generating account private key", err))
+	}
+	accountPublicKey := accountPrivateKey.PublicKey()
+
+	// Create account create transaction with hook
+	fmt.Println("Executing account create transaction with hook...")
+	response, err := hiero.NewAccountCreateTransaction().
+		SetKeyWithoutAlias(accountPublicKey).
+		AddHook(*hookDetail).
+		SetMaxTransactionFee(hiero.NewHbar(10)).
+		Execute(client)
+	if err != nil {
+		panic(fmt.Sprintf("%v : error creating account", err))
+	}
+	receipt, err := response.SetValidateStatus(true).GetReceipt(client)
+	if err != nil {
+		panic(fmt.Sprintf("%v : error getting account create transaction receipt", err))
+	}
+	fmt.Printf("Account created with hook: %v\n", receipt.AccountID)
+}
+
+func addHookToAccount(client *hiero.Client, hookContractId *hiero.ContractID) {
+	fmt.Println("Creating account without hook first...")
+
+	// Generate account private key
+	fmt.Println("Generating account private key...")
+	accountPrivateKey, err := hiero.PrivateKeyGenerateEd25519()
+	if err != nil {
+		panic(fmt.Sprintf("%v : error generating account private key", err))
+	}
+	accountPublicKey := accountPrivateKey.PublicKey()
+
+	// Create account create transaction without hook
+	fmt.Println("Executing account create transaction...")
+	response, err := hiero.NewAccountCreateTransaction().
+		SetKeyWithoutAlias(accountPublicKey).
+		Execute(client)
+	if err != nil {
+		panic(fmt.Sprintf("%v : error creating account", err))
+	}
+	receipt, err := response.SetValidateStatus(true).GetReceipt(client)
+	if err != nil {
+		panic(fmt.Sprintf("%v : error getting account create transaction receipt", err))
+	}
+	accountId := *receipt.AccountID
+	fmt.Printf("Account created: %v\n", accountId)
+
+	// Create hook detail
+	fmt.Println("  Creating hook details...")
+	hookDetail := hiero.NewHookCreationDetails().
+		SetExtensionPoint(hiero.ACCOUNT_ALLOWANCE_HOOK).
+		SetHookId(1).
+		SetLambdaEvmHook(*hiero.NewLambdaEvmHook().SetContractId(hookContractId))
+
+	// Create account update transaction to add hook
+	fmt.Println("Adding hook to account via update transaction...")
+	frozenUpdateTransaction, err := hiero.NewAccountUpdateTransaction().
+		SetAccountID(accountId).
+		AddHookToCreate(*hookDetail).
+		SetMaxTransactionFee(hiero.NewHbar(15)).
+		FreezeWith(client)
+	if err != nil {
+		panic(fmt.Sprintf("%v : error freezing account update transaction", err))
+	}
+	response, err = frozenUpdateTransaction.Sign(accountPrivateKey).Execute(client)
+	if err != nil {
+		panic(fmt.Sprintf("%v : error executing account update transaction", err))
+	}
+	_, err = response.GetReceipt(client)
+	if err != nil {
+		panic(fmt.Sprintf("%v : error getting account update transaction receipt", err))
+	}
+	fmt.Println("Hook added to account successfully!")
+}
+
+func deleteHookFromAccount(client *hiero.Client, hookContractId *hiero.ContractID) {
+	fmt.Println("  Creating account with hook first...")
+
+	// Create hook detail
+	hookDetail := hiero.NewHookCreationDetails().
+		SetExtensionPoint(hiero.ACCOUNT_ALLOWANCE_HOOK).
+		SetHookId(1).
+		SetLambdaEvmHook(*hiero.NewLambdaEvmHook().SetContractId(hookContractId))
+
+	// Generate account private key
+	fmt.Println("Generating account private key...")
+	accountPrivateKey, err := hiero.PrivateKeyGenerateEd25519()
+	if err != nil {
+		panic(fmt.Sprintf("%v : error generating account private key", err))
+	}
+	accountPublicKey := accountPrivateKey.PublicKey()
+
+	// Create account create transaction with hook
+	fmt.Println("Executing account create transaction with hook...")
+	response, err := hiero.NewAccountCreateTransaction().
+		SetKeyWithoutAlias(accountPublicKey).
+		AddHook(*hookDetail).
+		SetMaxTransactionFee(hiero.NewHbar(10)).
+		Execute(client)
+	if err != nil {
+		panic(fmt.Sprintf("%v : error creating account", err))
+	}
+	receipt, err := response.SetValidateStatus(true).GetReceipt(client)
+	if err != nil {
+		panic(fmt.Sprintf("%v : error getting account create transaction receipt", err))
+	}
+	accountId := *receipt.AccountID
+	fmt.Printf("  Account created with hook: %v\n", accountId)
+
+	// Create account update transaction to delete hook
+	fmt.Println("Deleting hook from account via update transaction...")
+	frozenUpdateTransaction, err := hiero.NewAccountUpdateTransaction().
+		SetAccountID(accountId).
+		AddHookToDelete(1).
+		SetMaxTransactionFee(hiero.NewHbar(15)).
+		FreezeWith(client)
+	if err != nil {
+		panic(fmt.Sprintf("%v : error updating account", err))
+	}
+	response, err = frozenUpdateTransaction.Sign(accountPrivateKey).Execute(client)
+	if err != nil {
+		panic(fmt.Sprintf("%v : error executing account update transaction", err))
+	}
+	_, err = response.GetReceipt(client)
+	if err != nil {
+		panic(fmt.Sprintf("%v : error getting account update transaction receipt", err))
+	}
+	fmt.Println("Hook deleted from account successfully!")
+}