FreezeBalance gRPC Method

Parameters

from

string

REQUIRED

delegateTo

string

REQUIRED

resource

string

REQUIRED

frozenBalance

integer

REQUIRED

Returns

transaction

object

raw_data

object

ref_block_bytes

string

ref_block_num

integer

ref_block_hash

string

expiration

integer

auths

array

data

string

contract

array

type

string

parameter

object

value

string

type_url

string

provider

string

ContractName

string

Permission_id

integer

scripts

string

timestamp

integer

fee_limit

integer

signature

array

ret

array

fee

integer

ret

string

contractRet

string

assetIssueID

string

withdraw_amount

integer

unfreeze_amount

integer

exchange_received_amount

integer

exchange_inject_another_amount

integer

exchange_withdraw_another_amount

integer

exchange_id

integer

shielded_transaction_fee

integer

orderId

string

orderDetails

array

makerOrderId

string

takerOrderId

string

fillSellQuantity

integer

fillBuyQuantity

integer

withdraw_expire_amount

integer

cancelUnfreezeV2Amount

object

txid

string

constant_result

array

result

object

result

boolean

code

string

message

string

energy_used

integer

logs

array

address

string

topics

array

data

string

internal_transactions

array

hash

string

caller_address

string

transferTo_address

string

callValueInfo

array

callValue

integer

tokenId

string

note

string

rejected

boolean

extra

string

energy_penalty

integer

Request

1
package main
2

3
import (
4
   "context"
5
   "crypto/tls"
6
   "encoding/json"
7
   "fmt"
8
   "github.com/fbsobreira/gotron-sdk/pkg/client"
9
   "github.com/fbsobreira/gotron-sdk/pkg/proto/core"
10
   "google.golang.org/grpc"
11
   "google.golang.org/grpc/credentials"
12
)
13

14
// Quicknode endpoints consist of two crucial components: the endpoint name and the corresponding token
15
// For eg: QN Endpoint: https://docs-demo.tron-mainnet.quiknode.pro/abcde123456789
16
// endpoint will be: docs-demo.tron-mainnet.quiknode.pro:50051  {50051 is the port number for Tron gRPC}
17
// token will be : abcde123456789
18

19
var token = "YOUR_TOKEN"
20
var endpoint = "YOUR_ENDPOINT:50051"
21

22
type auth struct {
23
   token string
24
}
25

26
func (a *auth) GetRequestMetadata(ctx context.Context, uri ...string) (map[string]string, error) {
27
   return map[string]string{
28
      "x-token": a.token,
29
   }, nil
30
}
31

32
func (a *auth) RequireTransportSecurity() bool {
33
   return false
34
}
35

36
// Convert SUN to TRX for display (1 TRX = 1,000,000 SUN)
37
func sunToTrx(sun int64) float64 {
38
   return float64(sun) / 1000000.0
39
}
40

41
func main() {
42

43
   opts := []grpc.DialOption{
44
      grpc.WithTransportCredentials(credentials.NewTLS(&tls.Config{})),
45
      grpc.WithPerRPCCredentials(&auth{token}),
46
   }
47
   conn := client.NewGrpcClient(endpoint)
48
   if err := conn.Start(opts...); err != nil {
49
      panic(err)
50
   }
51
   defer conn.Conn.Close()
52

53
   from := "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g"
54
   delegateTo := ""                             
55
   resource := core.ResourceCode_BANDWIDTH         
56
   frozenBalance := int64(10000000)
57
   
58
   resourceName := "BANDWIDTH"
59
   if resource == core.ResourceCode_ENERGY {
60
      resourceName = "ENERGY"
61
   }
62
   
63
   fmt.Printf("Checking balance for account %s...\n", from)
64
   account, err := conn.GetAccount(from)
65
   if err != nil {
66
      fmt.Printf("Error getting account: %v\n", err)
67
      return
68
   }
69
   
70
   currentBalance := account.GetBalance()
71
   fmt.Printf("Current balance: %d SUN (%.6f TRX)\n", currentBalance, sunToTrx(currentBalance))
72
   
73
   if currentBalance < frozenBalance {
74
      fmt.Printf("Error: Insufficient balance. Have: %d SUN (%.6f TRX), Need: %d SUN (%.6f TRX)\n", 
75
         currentBalance, sunToTrx(currentBalance), frozenBalance, sunToTrx(frozenBalance))
76
      if currentBalance > 1000000 { // At least 1 TRX available
77
         suggestedAmount := (currentBalance / 1000000) * 1000000 // Round down to nearest TRX
78
         fmt.Printf("\nAdjusting freeze amount to %d SUN (%.0f TRX) based on available balance\n",
79
            suggestedAmount, sunToTrx(suggestedAmount))
80
         frozenBalance = suggestedAmount
81
      } else {
82
         fmt.Println("\nYour balance is too low to freeze any meaningful amount of TRX.")
83
         fmt.Println("Please add more TRX to your account and try again.")
84
         return
85
      }
86
   }
87
   
88
   if delegateTo == "" {
89
      fmt.Printf("Freezing %d SUN (%.6f TRX) to obtain %s resources for own account\n", 
90
         frozenBalance, sunToTrx(frozenBalance), resourceName)
91
   } else {
92
      fmt.Printf("Freezing %d SUN (%.6f TRX) to delegate %s resources to account %s\n", 
93
         frozenBalance, sunToTrx(frozenBalance), resourceName, delegateTo)
94
   }
95
   
96
   fmt.Println("Creating freeze balance transaction...")
97
   
98
   tx, err := conn.FreezeBalance(
99
      from,          // From address
100
      delegateTo,    // Delegate to address (empty for self)
101
      resource,      // Resource type (BANDWIDTH or ENERGY)
102
      frozenBalance, // Amount to freeze in SUN
103
   )
104
   
105
   if err != nil {
106
      fmt.Printf("Error creating freeze transaction: %v\n", err)
107
      return
108
   }
109
   
110
   fmt.Println("Freeze transaction created successfully. Transaction details:")
111
   jsonData, _ := json.MarshalIndent(tx, "", "  ")
112
   fmt.Println(string(jsonData))
113
   
114
   // Broadcast the transaction
115
   fmt.Println("\nBroadcasting transaction to the TRON network...")
116
   result, err := conn.Broadcast(tx.Transaction)
117
   if err != nil {
118
      fmt.Printf("Error broadcasting transaction: %v\n", err)
119
      return
120
   }
121
   
122
   if !result.GetResult() {
123
      fmt.Printf("Broadcast failed: %s\n", result.GetMessage())
124
      return
125
   }
126
   
127
   fmt.Println("TRX frozen successfully! Result:")
128
   resultJSON, _ := json.MarshalIndent(result, "", "  ")
129
   fmt.Println(string(resultJSON))
130
}

1
package main
2

3
import (
4
   "context"
5
   "crypto/tls"
6
   "encoding/json"
7
   "fmt"
8
   "github.com/fbsobreira/gotron-sdk/pkg/client"
9
   "github.com/fbsobreira/gotron-sdk/pkg/proto/core"
10
   "google.golang.org/grpc"
11
   "google.golang.org/grpc/credentials"
12
)
13

14
// Quicknode endpoints consist of two crucial components: the endpoint name and the corresponding token
15
// For eg: QN Endpoint: https://docs-demo.tron-mainnet.quiknode.pro/abcde123456789
16
// endpoint will be: docs-demo.tron-mainnet.quiknode.pro:50051  {50051 is the port number for Tron gRPC}
17
// token will be : abcde123456789
18

19
var token = "YOUR_TOKEN"
20
var endpoint = "YOUR_ENDPOINT:50051"
21

22
type auth struct {
23
   token string
24
}
25

26
func (a *auth) GetRequestMetadata(ctx context.Context, uri ...string) (map[string]string, error) {
27
   return map[string]string{
28
      "x-token": a.token,
29
   }, nil
30
}
31

32
func (a *auth) RequireTransportSecurity() bool {
33
   return false
34
}
35

36
// Convert SUN to TRX for display (1 TRX = 1,000,000 SUN)
37
func sunToTrx(sun int64) float64 {
38
   return float64(sun) / 1000000.0
39
}
40

41
func main() {
42

43
   opts := []grpc.DialOption{
44
      grpc.WithTransportCredentials(credentials.NewTLS(&tls.Config{})),
45
      grpc.WithPerRPCCredentials(&auth{token}),
46
   }
47
   conn := client.NewGrpcClient(endpoint)
48
   if err := conn.Start(opts...); err != nil {
49
      panic(err)
50
   }
51
   defer conn.Conn.Close()
52

53
   from := "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g"
54
   delegateTo := ""                             
55
   resource := core.ResourceCode_BANDWIDTH         
56
   frozenBalance := int64(10000000)
57
   
58
   resourceName := "BANDWIDTH"
59
   if resource == core.ResourceCode_ENERGY {
60
      resourceName = "ENERGY"
61
   }
62
   
63
   fmt.Printf("Checking balance for account %s...\n", from)
64
   account, err := conn.GetAccount(from)
65
   if err != nil {
66
      fmt.Printf("Error getting account: %v\n", err)
67
      return
68
   }
69
   
70
   currentBalance := account.GetBalance()
71
   fmt.Printf("Current balance: %d SUN (%.6f TRX)\n", currentBalance, sunToTrx(currentBalance))
72
   
73
   if currentBalance < frozenBalance {
74
      fmt.Printf("Error: Insufficient balance. Have: %d SUN (%.6f TRX), Need: %d SUN (%.6f TRX)\n", 
75
         currentBalance, sunToTrx(currentBalance), frozenBalance, sunToTrx(frozenBalance))
76
      if currentBalance > 1000000 { // At least 1 TRX available
77
         suggestedAmount := (currentBalance / 1000000) * 1000000 // Round down to nearest TRX
78
         fmt.Printf("\nAdjusting freeze amount to %d SUN (%.0f TRX) based on available balance\n",
79
            suggestedAmount, sunToTrx(suggestedAmount))
80
         frozenBalance = suggestedAmount
81
      } else {
82
         fmt.Println("\nYour balance is too low to freeze any meaningful amount of TRX.")
83
         fmt.Println("Please add more TRX to your account and try again.")
84
         return
85
      }
86
   }
87
   
88
   if delegateTo == "" {
89
      fmt.Printf("Freezing %d SUN (%.6f TRX) to obtain %s resources for own account\n", 
90
         frozenBalance, sunToTrx(frozenBalance), resourceName)
91
   } else {
92
      fmt.Printf("Freezing %d SUN (%.6f TRX) to delegate %s resources to account %s\n", 
93
         frozenBalance, sunToTrx(frozenBalance), resourceName, delegateTo)
94
   }
95
   
96
   fmt.Println("Creating freeze balance transaction...")
97
   
98
   tx, err := conn.FreezeBalance(
99
      from,          // From address
100
      delegateTo,    // Delegate to address (empty for self)
101
      resource,      // Resource type (BANDWIDTH or ENERGY)
102
      frozenBalance, // Amount to freeze in SUN
103
   )
104
   
105
   if err != nil {
106
      fmt.Printf("Error creating freeze transaction: %v\n", err)
107
      return
108
   }
109
   
110
   fmt.Println("Freeze transaction created successfully. Transaction details:")
111
   jsonData, _ := json.MarshalIndent(tx, "", "  ")
112
   fmt.Println(string(jsonData))
113
   
114
   // Broadcast the transaction
115
   fmt.Println("\nBroadcasting transaction to the TRON network...")
116
   result, err := conn.Broadcast(tx.Transaction)
117
   if err != nil {
118
      fmt.Printf("Error broadcasting transaction: %v\n", err)
119
      return
120
   }
121
   
122
   if !result.GetResult() {
123
      fmt.Printf("Broadcast failed: %s\n", result.GetMessage())
124
      return
125
   }
126
   
127
   fmt.Println("TRX frozen successfully! Result:")
128
   resultJSON, _ := json.MarshalIndent(result, "", "  ")
129
   fmt.Println(string(resultJSON))
130
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free

FreezeBalance gRPC Method

Loading...

Parameters

Returns