Amber/README.md

Amber: Nostr event signer for Android

Designed to have your keys on only one application

Current Features

• Offline
• Use nip-46 or make an addendum in nip-46
• Improve the ui (currently its showing a text with the raw json of the event)
• Check if we can use Amber to sign the events of web applications

Adding Amber support for your application

• Add a package querie in your AndroidManifest.xml

<queries>
    <package android:name="com.greenart7c3.nostrsigner"/>
</queries>

• Create the Nostr Event

val event = TextNoteEvent(noteId = "", pubKey, TimeUtils.now(), tags, message, signature = "")

• Convert the event to json

val json = event.toJson()

• Create the intent using the nostrsigner scheme

val intent = Intent(Intent.ACTION_VIEW, Uri.parse("nostrsigner:$json"))

• Set the package name of the signer app for the intent

intent.`package` = "com.greenart7c3.nostrsigner"

• Start the signer Activity

context.startActivity(intent)

• In Amber you will see 3 buttons

  • The left one you can select the relays to post the Event
  • The button in the middle is to sign the event and copy the raw event json to the clipboard
  • The button on the right is to sign the event and send to the choosen relays

Contributing

Issues and pull requests are very welcome.