Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
3c6d67a
docs: enhance FeeAssessmentMethod enum docstring
cheese-cakee Jan 7, 2026
72b1af3
docs: enhance TokenType enum docstring
cheese-cakee Jan 7, 2026
2667e60
fix: replace EN DASH with HYPHEN-MINUS in docstring
cheese-cakee Jan 7, 2026
c2365e7
fix: replace EN DASH with HYPHEN-MINUS in docstring
cheese-cakee Jan 7, 2026
1177c49
docs: convert FeeAssessmentMethod docstring to Google-style with exam…
cheese-cakee Jan 8, 2026
5afc0bd
docs: convert TokenType docstring to Google-style with examples
cheese-cakee Jan 8, 2026
e4170b0
Trigger GitHub status update
cheese-cakee Jan 8, 2026
f12c689
Update to resolve GitHub status display issue
cheese-cakee Jan 8, 2026
9ef922c
Merge branch 'main' into fee-assessment-method-docstring-2
cheese-cakee Jan 8, 2026
92c9aa0
docs: update CHANGELOG to include FeeAssessmentMethod and TokenType d…
cheese-cakee Jan 8, 2026
49793e5
Trigger fresh status check after DCO fix
cheese-cakee Jan 8, 2026
61bbbdb
docs: enhance TokenType enum docstring
cheese-cakee Jan 7, 2026
5380884
fix: replace EN DASH with HYPHEN-MINUS in docstring
cheese-cakee Jan 7, 2026
4f286a4
docs: convert TokenType docstring to Google-style with examples
cheese-cakee Jan 8, 2026
b8f2842
Trigger GitHub status update
cheese-cakee Jan 8, 2026
d676b4b
Merge remote-tracking branch 'origin/token-type-docstring' into token…
cheese-cakee Jan 8, 2026
778ca9a
Merge branch 'token-type-docstring' into fee-assessment-method-docstr…
cheese-cakee Jan 8, 2026
dc7d909
Fix docstrings according to Google-style format
cheese-cakee Jan 8, 2026
325c861
Trigger GitHub UI refresh for docstring changes
cheese-cakee Jan 8, 2026
421a4dc
Merge Google-style docstring fixes
cheese-cakee Jan 8, 2026
1943d55
Merge updated changes
cheese-cakee Jan 8, 2026
da93ce6
Ensure GitHub UI updates with latest docstring fixes
cheese-cakee Jan 8, 2026
2d14aa3
Merge final changes
cheese-cakee Jan 8, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Changelog
# Changelog

All notable changes to this project will be documented in this file.
This project adheres to [Semantic Versioning](https://semver.org).
Expand All @@ -7,14 +7,16 @@ This changelog is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.
## [Unreleased]

### Added

- Added a notification workflow that alerts the support team when an issue is labeled as a Good First Issue Candidate.[(#1296)]
- Added comprehensive docstring to `TokenType` enum explaining fungible vs non-fungible tokens with use cases and examples. (#1392)
- Added comprehensive training documentation for the `Query` class, covering execution flow, payments, retries, and building child queries. (#1238)
- Beginner issue documentation and updated GFI and GFIC templates and documentation
- Enable auto assignment to good first issues (#1312), archived good first issue support team notification. Changed templates with new assign instruction.
- Intermediate issue documentation
- Added unit test for 'endpoint.py' to increase coverage.
- Automated assignment guard for `advanced` issues; requires completion of at least one `good first issue` and one `intermediate` issue before assignment (exempts maintainers, committers, and triage members). (#1142)
- Added comprehensive docstring to `FeeAssessmentMethod` enum explaining inclusive vs exclusive fee assessment methods. (#1391)
- Added comprehensive docstring to `TokenType` enum explaining fungible vs non-fungible tokens with use cases and examples. (#1392)
- Added Hbar object support for TransferTransaction HBAR transfers:
- Methods now accept `Union[int, Hbar]` for amount parameters with immediate normalization to tinybars
- Includes comprehensive unit tests covering various Hbar units (HBAR, MICROBAR, NANOBAR, TINYBAR) and accumulation behavior with mixed `int` and `Hbar` inputs
Expand Down
19 changes: 17 additions & 2 deletions src/hiero_sdk_python/tokens/fee_assessment_method.py
Original file line number Diff line number Diff line change
@@ -1,8 +1,23 @@
from enum import Enum

class FeeAssessmentMethod(Enum):
"""
Represents the fee assessment method for custom fees.
"""Fee assessment method for custom token fees.

Determines whether custom fees are deducted from the transferred amount
or charged separately.

Attributes:
INCLUSIVE: Fee is deducted from transferred amount.
The recipient receives the transferred amount minus fee.
EXCLUSIVE: Fee is charged in addition to transferred amount.
The recipient receives the full transferred amount, and the payer
pays the fee on top of that.

Example:
>>> # Using inclusive fee assessment
>>> assessment = FeeAssessmentMethod.INCLUSIVE
>>> print(f"Fee type: {assessment}")
Fee type: FeeAssessmentMethod.INCLUSIVE
"""

INCLUSIVE = 0
Expand Down
20 changes: 19 additions & 1 deletion src/hiero_sdk_python/tokens/token_type.py
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,24 @@
from enum import Enum

class TokenType(Enum):
"""Enum for Hedera token types: FUNGIBLE_COMMON or NON_FUNGIBLE_UNIQUE."""
"""Token type for Hedera tokens.

Determines whether a token represents a divisible, interchangeable
asset or a collection of unique, non-interchangeable assets.

Attributes:
FUNGIBLE_COMMON: Interchangeable tokens where each unit is equal.
Examples: cryptocurrencies, utility tokens, stablecoins.
Use for tokens where units can be divided and mixed freely.
NON_FUNGIBLE_UNIQUE: Unique tokens where each token is distinct and
cannot be replaced. Examples: NFTs, digital collectibles,
unique assets. Each token has its own metadata and identity.

Example:
>>> # Creating a fungible token
>>> token_type = TokenType.FUNGIBLE_COMMON
>>> print(f"Token type: {token_type}")
Token type: TokenType.FUNGIBLE_COMMON
"""
FUNGIBLE_COMMON = 0
NON_FUNGIBLE_UNIQUE = 1