chore: bump to v3.0.0

[raul-oliveira]

Acceptance Criteria

• Bump package to v3.0.0

Breaking Changes

From #1034 - feat: export all types and utils from public API:

The following types have been renamed at their source. External consumers importing the old names will need to update:

Old Name	New Name	Source File
Balance	WalletServiceBalance	src/wallet/types.ts
Authority	WalletServiceAuthority	src/wallet/types.ts
DelegateAuthorityOptions	WalletServiceDelegateAuthorityOptions	src/wallet/types.ts
DestroyAuthorityOptions	WalletServiceDestroyAuthorityOptions	src/wallet/types.ts
CreateNanoTxData	FullnodeCreateNanoTxData	src/new/types.ts

Note: The models/types.ts versions (Balance, Authority) and nano_contracts/types.ts version (CreateNanoTxData) keep their original names. Only the duplicates in wallet/types.ts and new/types.ts were renamed.

From #1038 - feat: single address policy:

HathorWallet default scan policy changed to SINGLE_ADDRESS

The constructor now defaults to { policy: SCANNING_POLICY.SINGLE_ADDRESS } when no scanPolicy is provided. Previously, omitting scanPolicy resulted in GAP_LIMIT behavior.

Consumers that relied on the default gap-limit behavior must now explicitly pass a scan policy:

new HathorWallet({
  // ...
  scanPolicy: { policy: SCANNING_POLICY.GAP_LIMIT, gapLimit: GAP_LIMIT },
});

HathorWallet first-connection auto-detection of address mode

On the first WebSocket connection, HathorWallet now automatically:

1. Checks the stored scanning policy.
2. If SINGLE_ADDRESS, attempts enableSingleAddressMode().
3. If the wallet has transactions on addresses beyond index 0, catches HasTxOutsideFirstAddressError and falls back to GAP_LIMIT.

This behavior did not exist in v2.x.

HathorWallet.changeServer() is now async

The method signature changed from changeServer(newServer: string): void to async changeServer(newServer: string): Promise<void>. TypeScript consumers that type-check the return value will need to update.

changeServer() added to IHathorWallet interface

The changeServer(newServer: string): Promise<void> method was added to the IHathorWallet interface. Consumers that implement this interface directly will need to add this method.

HathorWallet.getAddressAtIndex() no longer persists derived addresses

Previously, calling getAddressAtIndex() for an index not yet in storage would derive the address and save it via this.storage.saveAddress(address). It now derives and returns the address without persisting it.

What's included

PR	Type	Title
#1034	feat	export all types and utils from public API
#1038	feat	single address policy
#1054	fix	native token version defaulting to DEPOSIT
#1056	fix	precalculated wallet address derivation bug
#1046	refact	move fee test suite to the right folder
#1032	test	Shared tests for start
#1047	test	Shared tests for internal wallet methods
#1048	test	add new fee template integration tests
#1049	chore	improve CI integration test logs

Security Checklist

• Make sure you do not include new dependencies in the project unless strictly necessary and do not include dev-dependencies as production ones. More dependencies increase the possibility of one of them being hijacked and affecting us.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 79e32aaa-3f70-47d5-96a8-5ff232be2081

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch chore/bump-to-v2.18.0

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 87.93%. Comparing base (e4188b4) to head (c111886).
⚠️ Report is 1 commits behind head on release.

Additional details and impacted files

@@           Coverage Diff            @@
##           release    #1064   +/-   ##
========================================
  Coverage    87.93%   87.93%           
========================================
  Files          114      114           
  Lines         8910     8910           
  Branches      2020     2030   +10     
========================================
  Hits          7835     7835           
  Misses        1047     1047           
  Partials        28       28           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.