Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

0079 Python Code Samples 2 #78

Merged
merged 7 commits into from
Jan 19, 2023
Merged
Changes from all commits
Commits
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
39 changes: 39 additions & 0 deletions open_bounties/0079 Python Code Samples 2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
---
ID: 0079
Discussion: https://github.com/XRPLBounties/Proposals/discussions/79
Category: Technical Documentation
Status: Open
Amount: $5,000
---

# Python Code Samples 2

## This will not be merged until we receive budget approval even if we get 3+ technical approvals. Once merged, this bounty is ready to be worked on, please hold off starting work till merging. ##

## Overview

Currently, our Python documentations have [code snippets](https://github.com/XRPLF/xrpl-py/tree/master/snippets) and [code samples](https://github.com/XRPLF/xrpl-dev-portal/tree/master/content/_code-samples) for some common usecases. However, there needs to be more examples to capture common tasks that users would want the library to do. Developers would benefit from additional relevant, high quality, well-documented examples in Python.

## Details

To add missing code samples, follow the instructions at the bottom of the page, under **Contribute Code Samples**.

https://xrpl.org/code-samples.html

## Milestones

| # | Description | Details | Proposed Potential Award | Open? |
| --- | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ | ----- |
| 1 | NFT | Mint (or batch mint) and burn an [NFT Token](https://xrpl.org/non-fungible-tokens.html#non-fungible-tokens-overview), assign an authorized minter, transfer NFT tokens (create, cancel, and accept offer). | $1500 | Open |
| 2 | Require Destination Tags | Enable [Require Destionation Tags](https://xrpl.org/require-destination-tags.html#require-destination-tags) for an account. | $500 | Open |
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since this is for xrpl.org only we can remove Use Tickets, Escrow History, and Tickets should be removed.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think Tickets exists on xrpl.org for Python (List which Tickets are outstanding against one’s own account and use Tickets to collect signatures for multisign transactions)

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

use tickets does

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I didn't realize this bounty was for updating the code in guides. Do we need to update the description of the bounty then?

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yeah description could be more clear

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yeah but that's for use-tickets, Tickets have a different description - List which Tickets are outstanding against one’s own account and use Tickets to collect signatures for multisign transactions.

| 3 | Decentralized Exchange | Buy and sell tokens in the [decentralized exchange](https://xrpl.org/decentralized-exchange.html). Follow this [guidance](https://xrpl.org/decentralized-exchange.html) in JavaScript. | $500 | Open |
| 4 | Tickets | List which [Tickets](https://xrpl.org/use-tickets.html) are outstanding against one’s own account and use Tickets to collect signatures for multisign transactions. | $750 | Open |
| 5 | Account Deletion | Delete (or blackhole) an account. | $500 | Open |
| 6 | NFTs | List an account’s [NFT pages](https://xrpl.org/nftokenpage.html#nftokenpage) and see token offers for that account’s NFTs. | $750 | Open |
| 7 | Memo | Validate and send a [Memo](https://xrpl.org/transaction-common-fields.html#memos-field). | $500 | Open |

When submitting a PR completing one of these milestones, please link to this markdown file for the bounty:

- A milestone is complete only after the relevant code sample has been approved, merged, and deployed onto XRPL.org.
- All of these code samples must have feature parity with the existing equivalent code samples in other languages.
- They must also be well-documented to be a useful learning reference, not just working code which performs the task.