1. Attribute prefix - Module identifier

2. Address - Account address the attribute belongs to

3. Attribute name - The name of the attribute

4. Hash value - Hashed value of the attribute content

• Store a marshaled attribute record

• Retrieve the value it points to in the store

plain text
[0x02][address][attribute name][hashvalue]

go
// Attribute holds a typed key/value structure for data associated with an account
type Attribute struct {
    // The attribute name.
    Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`

    // The attribute value.
    Value []byte `protobuf:"bytes,2,opt,name=value,proto3" json:"value,omitempty"`

    // The attribute value type.
    AttributeType AttributeType `protobuf:"varint,3,opt,name=attribute_type,json=attributeType,proto3,enum=provenance.attribute.v1.AttributeType" json:"attribute_type,omitempty"`

    // The address the attribute is bound to
    Address string `protobuf:"bytes,4,opt,name=address,proto3" json:"address,omitempty"`
}

go
// AttributeType defines the type of the data stored in the attribute value
type AttributeType int32

const (
    // ATTRIBUTE_TYPE_UNSPECIFIED defines an unknown/invalid type
    AttributeType_Unspecified AttributeType = 0

    // ATTRIBUTE_TYPE_UUID defines an attribute value that contains a string value representation of a V4 uuid
    AttributeType_UUID AttributeType = 1

    // ATTRIBUTE_TYPE_JSON defines an attribute value that contains a byte string containing json data
    AttributeType_JSON AttributeType = 2

    // ATTRIBUTE_TYPE_STRING defines an attribute value that contains a generic string value
    AttributeType_String AttributeType = 3

    // ATTRIBUTE_TYPE_URI defines an attribute value that contains a URI
    AttributeType_Uri AttributeType = 4

    // ATTRIBUTE_TYPE_INT defines an attribute value that contains an integer (cast as int64)
    AttributeType_Int AttributeType = 5

    // ATTRIBUTE_TYPE_FLOAT defines an attribute value that contains a float
    AttributeType_Float AttributeType = 6

    // ATTRIBUTE_TYPE_PROTO defines an attribute value that contains a serialized proto value in bytes
    AttributeType_Proto AttributeType = 7

    // ATTRIBUTE_TYPE_BYTES defines an attribute value that contains an untyped array of bytes
    AttributeType_Bytes AttributeType = 8
)

plain text
State Store
├── Attribute Records (by composite key)
│   ├── [0x02][address1][name1][hash1] → Attribute{...}
│   ├── [0x02][address1][name2][hash2] → Attribute{...}
│   └── [0x02][address2][name1][hash3] → Attribute{...}
└── Index Structures (for efficient queries)

• Efficient Lookup: Composite keys enable fast retrieval

• Type Safety: Strongly typed attribute values

• Flexible Data: Support for 8 different data types

• Multiple Values: Same name can have different values per account

• Performance: Hash-based key generation for uniqueness

• Efficient Storage: Composite key structure for optimal performance

• Type Flexibility: 8 different attribute types for various data needs

• Account Binding: Attributes are securely tied to specific addresses

• Scalability: Hash-based keys prevent naming conflicts

• Fast Retrieval: Direct key-based lookups in the state store

protobuf
// MsgAddAttributeRequest defines an sdk.Msg type that is used to add a new attribute to an account.
// Attributes may only be set in an account by the account that the attribute name resolves to.
message MsgAddAttributeRequest {
    option (gogoproto.equal) = false;
    option (gogoproto.goproto_stringer) = false;
    option (gogoproto.stringer) = false;
    option (gogoproto.goproto_getters) = false;

    // The attribute name.
    string name = 1;
    // The attribute value.
    bytes value = 2;
    // The attribute value type.
    AttributeType attribute_type = 3;
    // The account to add the attribute to.
    string account = 4;
    // The address that the name must resolve to.
    string owner = 5;
    // Time that an attribute will expire.
    google.protobuf.Timestamp expiration_date = 6 [(gogoproto.stdtime) = true, (gogoproto.nullable) = true];
}

• Any components of the request do not pass basic integrity and format checks

• Attribute value exceeds the maximum length

• Unable to normalize the name

• The account does not exist

• The name does not resolve to the owner address

protobuf
// MsgUpdateAttributeRequest defines an sdk.Msg type that is used to update an existing attribute to an account.
// Attributes may only be set in an account by the account that the attribute name resolves to.
message MsgUpdateAttributeRequest {
    option (gogoproto.equal) = false;
    option (gogoproto.goproto_stringer) = false;
    option (gogoproto.stringer) = false;
    option (gogoproto.goproto_getters) = false;

    // The attribute name.
    string name = 1;
    // The original attribute value.
    bytes original_value = 2;
    // The update attribute value.
    bytes update_value = 3;
    // The original attribute value type.
    AttributeType original_attribute_type = 4;
    // The update attribute value type.
    AttributeType update_attribute_type = 5;
    // The account to add the attribute to.
    string account = 6;
    // The address that the name must resolve to.
    string owner = 7;
}

• Any components of the request do not pass basic integrity and format checks

• Updated attribute value exceeds the maximum length

• Unable to normalize the original or updated attribute name

• Updated name and the original name don't match

• The owner account does not exist

• The updated name does not resolve to the owner address

• The original attribute does not exist

protobuf
// MsgUpdateAttributeExpirationRequest defines an sdk.Msg type that is used to update an existing attribute's expiration
// date
message MsgUpdateAttributeExpirationRequest {
    option (gogoproto.equal) = true;
    option (gogoproto.stringer) = true;
    option (gogoproto.goproto_stringer) = false;

    // The attribute name.
    string name = 1;
    // The original attribute value.
    bytes value = 2;
    // Time that an attribute will expire.
    google.protobuf.Timestamp expiration_date = 3 [(gogoproto.stdtime) = true, (gogoproto.nullable) = true];
    // The account to add the attribute to.
    string account = 4;
    // The address that the name must resolve to.
    string owner = 5;
}

• Any components of the request do not pass basic integrity and format checks

• The owner account does not exist

• The name does not resolve to the owner address

• The attribute does not exist

• The expiration date is before current block height

protobuf
// MsgDeleteAttributeRequest defines a message to delete an attribute from an account
// Attributes may only be removed from an account by the account that the attribute name resolves to.
message MsgDeleteAttributeRequest {
    option (gogoproto.equal) = false;
    option (gogoproto.goproto_stringer) = false;
    option (gogoproto.stringer) = false;
    option (gogoproto.goproto_getters) = false;

    // The attribute name.
    string name = 1;
    // The account to add the attribute to.
    string account = 2;
    // The address that the name must resolve to.
    string owner = 3;
}

• Any components of the request do not pass basic integrity and format checks

• The owner account does not exist

• The name does not resolve to the owner address

• The attribute does not exist

protobuf
// MsgDeleteDistinctAttributeRequest defines a message to delete an attribute with matching name, value, and type from
// an account. Attributes may only be removed from an account by the account that the attribute name resolves to.
message MsgDeleteDistinctAttributeRequest {
    option (gogoproto.equal) = false;
    option (gogoproto.goproto_stringer) = false;
    option (gogoproto.stringer) = false;
    option (gogoproto.goproto_getters) = false;

    // The attribute name.
    string name = 1;
    // The attribute value.
    bytes value = 2;
    // The account to add the attribute to.
    string account = 3;
    // The address that the name must resolve to.
    string owner = 4;
}

• Any components of the request do not pass basic integrity and format checks

• The owner account does not exist

• The name does not resolve to the owner address

• The attribute does not exist

protobuf
// MsgSetAccountDataRequest defines a message to set an account's accountdata attribute.
message MsgSetAccountDataRequest {
    option (cosmos.msg.v1.signer) = "account";

    string value = 1;
    string account = 2;
}

• The value is too long (as defined in attribute module params)

• The message is not signed by the provided account

• All operations require name resolution to owner address

• Account existence validation

• Integrity and format checking

• Maximum length enforcement

• Proper signing requirements

• Before/After Values: Complete audit trail of changes

• Type Changes: Tracks data type modifications

• Owner Validation: Ensures proper authorization

• Exact Match: Deletes only attributes with specific name + value + type

• Granular Control: Allows precise attribute removal

• Value Tracking: Records the exact value that was removed

• System Triggered: No manual intervention required

• Complete Audit: Full details of expired attribute

• Timestamp Verification: Exact expiration time recorded

• Account-Level Changes: Tracks broader account data modifications

• Integration Point: Useful for account monitoring systems

• Creation: Full details of new attributes

• Modification: Before/after change tracking

• Deletion: Multiple deletion patterns supported

• Expiration: Automatic lifecycle management

• Owner Information: Authentication and authorization details

• Value Tracking: Complete data change history

• Type Safety: Attribute type information included

• Timestamp Data: Expiration and modification times

• Compliance: Complete audit trails for regulatory requirements

• Monitoring: Real-time attribute change detection

• Integration: Rich event data for external systems

• Debugging: Detailed operation tracking for troubleshooting