merge upsource

.codecov.yml

@@ -0,0 +1,15 @@
+coverage:
+  status:
+    project:
+      default:
+        target: 80%
+        threshold: 2%
+    patch:
+      default:
+        target: 80%
+
+ignore:
+  - "cmd/**"
+  - "examples/**"
+  - "pkg/proto/**"
+  - "**/*.pb.go"

.coderabbit.yaml

@@ -0,0 +1,57 @@
+# yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json
+language: en-US
+early_access: true
+tone_instructions: >
+  Be concise and direct. Focus on correctness, security, and Go idioms.
+reviews:
+  profile: chill
+  request_changes_workflow: true
+  high_level_summary: true
+  sequence_diagrams: true
+  collapse_walkthrough: true
+  poem: false
+  review_status: true
+  auto_review:
+    enabled: true
+    drafts: false
+    base_branches:
+      - master
+  path_filters:
+    - "!**/*.pb.go"
+    - "!vendor/**"
+  path_instructions:
+    - path: "pkg/proto/**"
+      instructions: "Auto-generated protobuf code. Do not review for style or conventions."
+    - path: "cmd/**"
+      instructions: "CLI layer using Cobra framework. Focus on UX, flag handling, and error messages."
+    - path: "pkg/client/**"
+      instructions: >
+        Core gRPC client for TRON blockchain. Focus on error handling,
+        resource management, and API correctness.
+    - path: "pkg/keys/**"
+      instructions: >
+        Cryptographic key management with HD wallets (BIP39/BIP44).
+        Pay close attention to security: key material handling,
+        constant-time comparisons, and proper zeroing of sensitive data.
+    - path: "pkg/keystore/**"
+      instructions: >
+        Encrypted keystore implementation. Review for secure storage
+        practices, proper encryption, and safe key derivation.
+    - path: "pkg/address/**"
+      instructions: "TRON address encoding/decoding with Base58 checksum validation."
+  tools:
+    gitleaks:
+      enabled: true
+    actionlint:
+      enabled: true
+    yamllint:
+      enabled: true
+    checkmake:
+      enabled: true
+chat:
+  auto_reply: true
+knowledge_base:
+  learnings:
+    scope: local
+  issues:
+    scope: local

.env.example

@@ -0,0 +1,24 @@
+# tronctl environment variables
+# Copy this file to .env in your working directory.
+# tronctl auto-loads .env from the current directory on startup.
+# Explicit flags (--node, --ks-dir, etc.) always take precedence.
+
+# gRPC node endpoint (default: grpc.trongrid.io:50051)
+# TRONCTL_NODE=grpc.trongrid.io:50051
+
+# Enable TLS for gRPC connection (set to any value to enable)
+# TRONCTL_TLS=true
+
+# TronGrid API key for authenticated access
+# TRONGRID_APIKEY=your-api-key-here
+
+# Default signer address (base58)
+# TRONCTL_SIGNER=TYourSignerAddressHere
+
+# Keystore directory (default: ~/.tronctl/account-keys)
+# TRONCTL_KS_DIR=/path/to/keystores
+
+# Debug flags
+# TRONCTL_GRPC_DEBUG=true
+# TRONCTL_TX_DEBUG=true
+# TRONCTL_ALL_DEBUG=true

.githooks/commit-msg

@@ -0,0 +1,33 @@
+#!/bin/bash
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+NC='\033[0m' # No Color
+
+COMMIT_MSG_FILE=$1
+COMMIT_MSG=$(cat $COMMIT_MSG_FILE)
+
+# Define regex patterns for commit message
+CONVENTIONAL_PATTERN='^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\(.+\))?: .{1,100}'
+TICKET_PATTERN='(TRON-[0-9]+)'
+
+# Check if commit message follows conventional commits pattern
+if ! [[ $COMMIT_MSG =~ $CONVENTIONAL_PATTERN ]]; then
+    echo -e "${RED}Error:${NC} Commit message does not follow conventional commits format."
+    echo -e "${YELLOW}Format:${NC} type(scope): description"
+    echo -e "${YELLOW}Example:${NC} feat(cli): add new transaction command"
+    echo -e "${YELLOW}Types:${NC} feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert"
+    exit 1
+fi
+
+# Warn if no ticket number is found (but don't block commit)
+if ! [[ $COMMIT_MSG =~ $TICKET_PATTERN ]]; then
+    echo -e "${YELLOW}Warning:${NC} No TRON-XXX ticket number found in commit message."
+    echo -e "${YELLOW}Consider:${NC} Including ticket number like TRON-123 in description or scope"
+fi
+
+echo -e "${GREEN}✓${NC} Commit message format is valid"
+exit 0

.githooks/install.sh

@@ -0,0 +1,34 @@
+#!/bin/bash
+set -e
+
+HOOK_DIR=$(git rev-parse --git-path hooks)
+REPO_ROOT=$(git rev-parse --show-toplevel)
+HOOKS_DIR="$REPO_ROOT/.githooks"
+
+# Make sure hooks are executable
+chmod +x "$HOOKS_DIR/pre-commit"
+chmod +x "$HOOKS_DIR/commit-msg"
+chmod +x "$HOOKS_DIR/prepare-commit-msg"
+
+# Create symlinks to hooks
+ln -sf "$HOOKS_DIR/pre-commit" "$HOOK_DIR/pre-commit"
+ln -sf "$HOOKS_DIR/commit-msg" "$HOOK_DIR/commit-msg"
+ln -sf "$HOOKS_DIR/prepare-commit-msg" "$HOOK_DIR/prepare-commit-msg"
+
+echo "✅ Git hooks installed successfully!"
+echo "Pre-commit hook will run: format, lint and test on staged files"
+echo "Commit-msg hook will enforce conventional commit format"
+echo "Prepare-commit-msg hook will provide a commit message template"
+
+# Check for required tools
+echo "Checking required tools..."
+
+if ! command -v goimports &> /dev/null; then
+    echo "⚠️ goimports not found. Please install with:"
+    echo "  go install golang.org/x/tools/cmd/goimports@latest"
+fi
+
+if ! command -v golangci-lint &> /dev/null; then
+    echo "⚠️ golangci-lint not found. Please install with:"
+    echo "  curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin"
+fi

.githooks/pre-commit

@@ -0,0 +1,63 @@
+#!/bin/bash
+set -e
+
+echo "==> Running pre-commit checks..."
+
+# Get staged Go files
+STAGED_GO_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep '\.go$' | grep -v '\.pb\.go$' || true)
+
+# Skip if no Go files are staged
+if [ -z "$STAGED_GO_FILES" ]; then
+    echo "No Go files staged. Skipping pre-commit checks."
+    exit 0
+fi
+
+# Check for goimports
+if ! command -v goimports &> /dev/null; then
+    echo "goimports not found! Please install with:"
+    echo "go install golang.org/x/tools/cmd/goimports@latest"
+    exit 1
+fi
+
+# Check for golangci-lint
+if ! command -v golangci-lint &> /dev/null; then
+    echo "golangci-lint not found! Please install with:"
+    echo "curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin"
+    exit 1
+fi
+
+# Format imports
+echo "Running goimports..."
+make goimports
+
+# Run go mod tidy
+echo "Checking go.mod and go.sum..."
+go mod tidy
+if [ -n "$(git diff --name-only go.mod go.sum)" ]; then
+    echo "go.mod or go.sum was modified. Please stage the changes."
+    git diff --name-only go.mod go.sum
+    exit 1
+fi
+
+# Get unique packages from staged files
+STAGED_PACKAGES=$(echo "$STAGED_GO_FILES" | xargs -I{} dirname {} | sort -u)
+
+# Run linter on affected packages
+echo "Running linter on staged packages..."
+for pkg in $STAGED_PACKAGES; do
+    golangci-lint run --fast ./$pkg
+done
+
+# Run tests affected by staged files
+echo "Running relevant tests..."
+
+# Run tests only for affected packages
+for pkg in $STAGED_PACKAGES; do
+    if [ -n "$(find $pkg -name '*_test.go' -type f | head -1)" ]; then
+        echo "Testing package: $pkg"
+        go test -race ./$pkg
+    fi
+done
+
+echo "✅ Pre-commit checks passed"
+exit 0

.githooks/prepare-commit-msg

@@ -0,0 +1,38 @@
+#!/bin/bash
+
+COMMIT_MSG_FILE=$1
+COMMIT_SOURCE=$2
+SHA1=$3
+
+# Only add template if this is not from a merge, amend, etc.
+if [ -z "$COMMIT_SOURCE" ]; then
+    # Check if the commit message already has content (non-commented lines)
+    if ! grep -q '^[^#]' "$COMMIT_MSG_FILE"; then
+        # Get the current branch name
+        BRANCH_NAME=$(git symbolic-ref --short HEAD 2>/dev/null)
+
+        # Extract ticket number from branch name if it follows pattern like feature/TRON-123-description
+        TICKET=""
+        if [[ $BRANCH_NAME =~ (TRON-[0-9]+) ]]; then
+            TICKET=${BASH_REMATCH[1]}
+        fi
+
+        # Add commit message template
+        cat > "$COMMIT_MSG_FILE" << EOF
+# Select commit type and add optional scope and description
+# Format: type(scope): description
+# Example: feat(cli): add new transaction feature
+# Types: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert
+# 
+# If applicable, include the TRON ticket number in scope or description
+# Current branch: $BRANCH_NAME
+EOF
+
+        # If we found a ticket number in the branch name, add it to the template
+        if [ -n "$TICKET" ]; then
+            echo "feat($TICKET): " > "$COMMIT_MSG_FILE.tmp"
+            cat "$COMMIT_MSG_FILE" >> "$COMMIT_MSG_FILE.tmp"
+            mv "$COMMIT_MSG_FILE.tmp" "$COMMIT_MSG_FILE"
+        fi
+    fi
+fi

.github/ISSUE_TEMPLATE/SECURITY.md

@@ -0,0 +1,33 @@
+# Security Policy
+
+## Supported Versions
+
+The following versions of gotron-sdk are currently being supported with security updates:
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 2.3.x   | :white_check_mark: |
+| 2.2.x   | :white_check_mark: |
+| 2.1.x   | :x:                |
+| < 2.0   | :x:                |
+
+## Reporting a Vulnerability
+
+We take the security of gotron-sdk seriously. If you believe you've found a security vulnerability, please follow these steps:
+
+1. **Do not disclose the vulnerability publicly**
+2. **Email us directly** at security@gotron.sh
+3. **Include the following information**:
+   - A description of the vulnerability
+   - Steps to reproduce the issue
+   - Potential impact of the vulnerability
+   - If possible, a suggested fix or mitigation
+
+## What to expect
+
+- We will acknowledge receipt of your vulnerability report within 3 business days
+- We will provide an initial assessment of the report within 10 business days
+- We will keep you informed about our progress throughout the process
+- We will notify you when the issue is fixed
+
+Thank you for helping keep gotron-sdk and its users safe!

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: TRON SDK Documentation
+    url: https://github.com/fbsobreira/gotron-sdk/wiki
+    about: Check if your question is answered in the documentation.
+  - name: TRON Network Documentation
+    url: https://developers.tron.network/
+    about: Learn more about TRON network specifications and APIs.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,32 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+---
+
+## Is your feature request related to a problem? Please describe.
+<!-- A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] -->
+
+## Describe the solution you'd like
+<!-- A clear and concise description of what you want to happen. -->
+
+## Describe alternatives you've considered
+<!-- A clear and concise description of any alternative solutions or features you've considered. -->
+
+## API Design (if applicable)
+<!-- If this feature involves new API methods, please describe the proposed function signatures. -->
+```go
+// Example API design
+func NewFeature(param1 string, param2 int) (Result, error) {
+    // Description of what this would do
+}
+```
+
+## Ticket
+<!-- If there's a related ticket, please reference it here -->
+TRON-
+
+## Additional context
+<!-- Add any other context or screenshots about the feature request here. -->

.github/ISSUE_TEMPLATE/question.md

@@ -0,0 +1,28 @@
+---
+name: Question
+about: Ask a question about using this SDK
+title: '[QUESTION] '
+labels: question
+assignees: ''
+---
+
+## Question
+<!-- Ask your question clearly and provide as much context as possible -->
+
+## Context
+<!-- Describe what you're trying to accomplish and what you've tried so far -->
+
+## Environment
+ - OS: [e.g. Ubuntu 22.04, macOS 13.0, Windows 11]
+ - Go version: [e.g. 1.20.4]
+ - TRON node version: 
+ - SDK version: [e.g. v2.3.0]
+
+## Code Example
+<!-- If applicable, provide code samples related to your question -->
+```go
+// Your code here
+```
+
+## Additional Information
+<!-- Add any other context about your question here -->