Skip to content

Commit

Permalink
chore: fix formatting
Browse files Browse the repository at this point in the history
Signed-off-by: Michael Kantor <[email protected]>
  • Loading branch information
kantorcodes committed Feb 14, 2024
1 parent ddf03d0 commit 93f997b
Showing 1 changed file with 19 additions and 14 deletions.
33 changes: 19 additions & 14 deletions HIP/hip-874.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,22 @@
HIP: 874
Title: Enhancing Topic Metadata Accessibility in the Hedera REST API
---
hip: 874
title: Enhancing Topic Metadata Accessibility in the Hedera REST API
Author(s): Michael Kantor (@kantorcodes), Ty Smith (@ty-swirldslabs)
Type: Standards Track
Category: API
Status: Draft
Created: 2024-02-14

Abstract:
type: Standards Track
category: API
status: Draft
created: 2024-02-14
requested-by: @TierBot
discussions-to: https://github.com/hashgraph/hedera-improvement-proposal/pull/883
---

## Abstract:
This HIP proposes an enhancement to the Hedera REST API to enable access to topic ID metadata, including the memo field and other relevant entity information. Currently, there is limited direct access to topic metadata through the REST API, which can hinder the development of applications that rely on this data for functionality or auditing purposes. This proposal aims to streamline access to topic metadata, reducing the need for workarounds and enhancing the capabilities of applications built on Hedera.

Motivation:
## Motivation:
The ability to access topic ID metadata, including the memo field, submit key, and deleted field directly through the REST API is crucial for a wide range of applications, including messaging, event tracking, and audit-ability functions. Currently, developers may need to employ indirect methods or multiple API calls to retrieve this information, leading to inefficiencies and potential inaccuracies. By providing direct access to this metadata, the proposal seeks to enhance developer experience, reduce computational load, and foster the development of more feature-rich applications on the Hedera platform.

Specification:
## Specification:
The proposed enhancement involves extending the REST API to include a new endpoint or modify existing endpoints to return topic ID metadata, including the memo field and other relevant entity information.

Route:
Expand All @@ -23,6 +27,7 @@ Current Response Structure returns:


Proposed Response Structure:
```json
{
"id": "0.0.123456",
"memo": "[Topic Memo]",
Expand All @@ -33,15 +38,15 @@ Proposed Response Structure:
"auto_renew_account_id": "0.0.654321",
"created_timestamp": "[Creation Time]"
}

```

The addition of memo, created_timestamp, last_updated_time, deleted, admin_key , auto_renew_period, submit_key ,auto_renew_account_id,id fields will provide comprehensive metadata about topics directly through the API.

Rationale:
### Rationale:
Providing direct access to topic ID metadata, including the memo and other relevant information, addresses a critical need for developers building on the Hedera network. This enhancement will facilitate a range of applications, from simple messaging systems to complex, multi-layered applications requiring detailed audit trails. The proposal supports the principles of transparency, efficiency, and developer friendliness that are essential to the Hedera ecosystem.

Backwards Compatibility:
### Backwards Compatibility:
This change is designed to be backwards compatible, adding new fields to the API response without altering existing fields or endpoint behaviors. This ensures that existing applications will continue to operate without modification, while new and updated applications can take advantage of the enhanced metadata accessibility.

Security Implications:
### Security Implications:
The proposal does not introduce significant changes to the security posture of the Hedera API. Access controls and authentication mechanisms remain unchanged, ensuring that the introduction of additional metadata fields does not compromise the integrity or confidentiality of data within the Hedera network.

0 comments on commit 93f997b

Please sign in to comment.