Skip to content

firewall: fix 32-bit int truncation and optimize CryptoRandIntn#1358

Open
bitromortac wants to merge 3 commits into
lightninglabs:masterfrom
bitromortac:2607-fix-32-overflow
Open

firewall: fix 32-bit int truncation and optimize CryptoRandIntn#1358
bitromortac wants to merge 3 commits into
lightninglabs:masterfrom
bitromortac:2607-fix-32-overflow

Conversation

@bitromortac

Copy link
Copy Markdown
Contributor

Fixes integer truncation on 32-bit runtimes by promoting the signature of randIntn and its fuzzer helpers from int to int64. This ensures UnixNano timestamps and large satoshi amounts do not overflow or truncate when calling ForwardingHistory.

Additionally, optimizes CryptoRandIntn by introducing a sync.Pool for *big.Int allocations, eliminating heap allocation overhead and GC pressure when fuzzing large lists of records in loop bodies.

Fixes #1357

@gemini-code-assist

Copy link
Copy Markdown

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request addresses potential integer truncation issues on 32-bit architectures by standardizing the use of int64 for random number generation and related calculations. It also introduces performance optimizations for cryptographic random number generation by reusing big.Int objects via a sync.Pool, which improves efficiency during high-frequency operations.

Highlights

  • Integer Promotion: Promoted randIntn and related helper signatures from int to int64 to prevent integer truncation on 32-bit runtimes.
  • Performance Optimization: Introduced a sync.Pool for *big.Int allocations in CryptoRandIntn to reduce heap allocation overhead and GC pressure.
  • Safety Improvements: Added overflow checks in hideAmount to ensure large amounts are handled safely.
New Features

🧠 You can now enable Memory (public preview) to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize the Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counterproductive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request refactors the privacy mapper to use int64 instead of int for random number generation, preventing architecture-dependent truncation on 32-bit systems. It also introduces a sync.Pool for *big.Int to optimize allocations in CryptoRandIntn and adds tests for 32-bit overflow. A potential bug was identified in hideAmount where the randomized upper bound amountMax can still overflow int64 and cause a signed integer wrap-around, leading to failures in randBetween.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread firewall/privacy_mapper.go
Upgrade the randIntn function signature from int to int64 to prevent
unpredictable integer truncation on 32-bit systems (e.g., Raspberry Pi).
This ensures UnixNano timestamps in hideTimestamp and large amounts in
hideAmount do not cause unexpected runtime failures when calling
ForwardingHistory.
Utilize a sync.Pool for *big.Int instances in CryptoRandIntn to avoid
frequent heap allocations. This significantly reduces garbage collection
pressure when randomizing timestamps, amounts, and fees inside loops
(e.g. iterating over forwarding history responses).
Add a succinct release note entry detailing the 32-bit truncation prevention and allocation optimization introduced by PR-1358.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Privacy mapper: 32-bit int truncation of UnixNano in hideTimestamp breaks ForwardingHistory ("min is not allowed to be greater than max")

2 participants